Notify users when an Ads account is suspended

js/src/dashboard/ads-account-suspended/index.js

@@ -0,0 +1,74 @@
+/**
+ * External dependencies
+ */
+import { __ } from '@wordpress/i18n';
+import { Notice } from '@wordpress/components';
+import { useState } from '@wordpress/element';
+import { Icon, external as externalIcon, warning as warningIcon } from '@wordpress/icons';
+
+/**
+ * Internal dependencies
+*/
+import './index.scss';
+
+/**
+ * Renders a Notice component with extra props.
+ *
+ * ## Usage
+ *
+ * ```jsx
+ * <AdsAccountSuspended >
+ * 		My Notice
+ * </AdsAccountSuspended>
+ * ```
+ */
+const AdsAccountSuspended = () => {
+	const [ isShown, setIsShown ] = useState( true );
+	const isSuspended = true;
+	if ( ! isSuspended ) {
+		return null;
+	}
+
+	const getActionLabel = () => (
+		<>
+			{ __(
+				'Resolve issues.',
+				'google-listings-and-ads'
+			) }
+			<Icon
+				className="gla-get-started-notice__icon"
+				icon={ externalIcon }
+				size={ 18 }
+			/>
+		</>
+	);
+
+	return ( isShown &&
+		<Notice
+			className="gla-ads-suspended-notice"
+			status="error"
+			onDismiss={ () => setIsShown( false ) }
+			actions={[
+				{
+				  label: getActionLabel(),
+				  onClick: 'https://ads.google.com/aw/overview?euid=0',
+				  className: 'gla-ads-suspended-notice__action',
+				},
+			]}
+		>
+			<p className="gla-ads-suspended-notice__message">
+				<Icon
+					icon={ warningIcon }
+					size={ 24 }
+					className="gla-ads-suspended-notice__icon"
+				/>
+				{ __(
+					'Your Google Ads account has been suspended. Your campaigns are not running.',
+					'google-listings-and-ads'
+				) }
+			</p>
+		</Notice>
+	);
+};
+
+export default AdsAccountSuspended;

js/src/dashboard/ads-account-suspended/index.scss

@@ -0,0 +1,19 @@
+.components-notice.gla-ads-suspended-notice {
+	background-color: white;
+	margin-bottom: $grid-unit-20;
+
+	.gla-ads-suspended-notice__message {
+		align-items: center;
+		display: flex;
+		margin-top: 0;
+		gap: $grid-unit-05;
+	}
+
+	.gla-ads-suspended-notice__icon {
+		fill: $alert-red;
+	}
+
+	.components-notice__actions {
+		margin-left: $grid-unit-20;
+	}
+}

js/src/dashboard/index.js

@@ -13,6 +13,7 @@ import AppButton from '.~/components/app-button';
 import DifferentCurrencyNotice from '.~/components/different-currency-notice';
 import MainTabNav from '.~/components/main-tab-nav';
 import CustomerEffortScorePrompt from '.~/components/customer-effort-score-prompt';
+import AdsAccountSuspended from './ads-account-suspended';
 import AppDateRangeFilterPicker from './app-date-range-filter-picker';
 import SummarySection from './summary-section';
 import CampaignCreationSuccessGuide from './campaign-creation-success-guide';
@@ -87,6 +88,7 @@ const Dashboard = () => {
 	return (
 		<>
 			<div className="gla-dashboard">
+				<AdsAccountSuspended />
 				<DifferentCurrencyNotice context="dashboard" />
 				<MainTabNav />
 				<RebrandingTour />

src/API/Google/Ads.php

@@ -322,6 +322,36 @@ private function get_account_details( string $account ): ?array {
 		return null;
 	}
 
+	/**
+	 * Get the account status.
+	 *
+	 * @return string|null Account status.
+	 */
+	public function get_account_status() {
+		try {
+			$ads_id   = $this->options->get_ads_id();
+			$account  = ResourceNames::forCustomer( $ads_id );
+			$customer = ( new AdsAccountQuery() )
+				->set_client( $this->client, $ads_id )
+				->columns( [ 'customer.status' ] )
+				->where( 'customer.resource_name', $account, '=' )
+				->get_result()
+				->getCustomer();
+
+			if ( ! $customer ) {
+				return null;
+			}
+
+			$status = $customer->getStatus();
+
+		} catch ( ApiException $e ) {
+			do_action( 'woocommerce_gla_ads_client_exception', $e, __METHOD__ );
+			$status = null;
+		}
+
+		return $status;
+	}
+
 	/**
 	 * Get the link from a merchant account.
 	 *

src/API/Google/Query/AdsAccountQuery.php

@@ -17,6 +17,6 @@ class AdsAccountQuery extends AdsQuery {
 	 */
 	public function __construct() {
 		parent::__construct( 'customer' );
-		$this->columns( [ 'customer.id', 'customer.descriptive_name', 'customer.manager', 'customer.test_account' ] );
+		$this->columns( [ 'customer.id', 'customer.descriptive_name', 'customer.manager', 'customer.test_account', 'customer.status' ] );
 	}
 }

src/Ads/AccountService.php

@@ -93,6 +93,15 @@ public function get_connected_account(): array {
 			$status['step']   = $incomplete;
 		}
 
+		if ( $id > 0 ) {
+			$customer_status = $this->container->get( Ads::class )->get_account_status();
+
+			// @todo: use ENUM for these values.
+			// 4 maps to 'SUSPENDED' in the API.
+			// See: https://github.com/googleads/google-ads-php/blob/legacy-v22.1.0/src/Google/Ads/GoogleAds/V16/Enums/CustomerStatusEnum/CustomerStatus.php
+			$status['account_status'] = ( 4 === $customer_status ) ? 'suspended' : 'active';
+		}
+
 		$status += $this->state->get_step_data( 'set_id' );
 
 		return $status;