Update Google AdWords connector and troubleshoot doc

Author: Clare-Zheng82

articles/data-factory/connector-google-adwords.md

@@ -8,7 +8,7 @@ ms.service: data-factory
 ms.subservice: data-movement
 ms.topic: conceptual
 ms.custom: synapse
-ms.date: 09/09/2021
+ms.date: 02/24/2022
 ---
 
 # Copy data from Google AdWords using Azure Data Factory or Synapse Analytics
@@ -19,7 +19,7 @@ ms.date: 09/09/2021
 This article outlines how to use the Copy Activity in an Azure Data Factory or Synapse Analytics pipeline to copy data from Google AdWords. It builds on the [copy activity overview](copy-activity-overview.md) article that presents a general overview of copy activity.
 
 > [!Important]
-> Due to the sunset of Google AdWords API by April 27, 2022, the service has upgraded to the new Google Ads API. Please refer this [document](connector-troubleshoot-google-adwords.md) for detailed migration steps and recommendations. Please make sure the migration to be done before April 27,2022.  
+> Due to the sunset of Google AdWords API by April 27, 2022, the service has upgraded to the new Google Ads API. Please refer this [document](connector-troubleshoot-google-adwords.md) for detailed migration steps and recommendations. Please make sure the migration to be done before **April 27,2022**.  
 
 ## Supported capabilities
 
@@ -71,7 +71,10 @@ The following properties are supported for Google AdWords linked service:
 | Property | Description | Required |
 |:--- |:--- |:--- |
 | type | The type property must be set to: **GoogleAdWords** | Yes |
+| connectionProperties | A group of properties that defines how to connect to Google AdWords. | Yes |
+| ***Under `connectionProperties`:*** | | |
 | clientCustomerID | The Client customer ID of the AdWords account that you want to fetch report data for.  | Yes |
+| loginCustomerID | The customer ID of the Google AdWords manager account through which you want to fetch report data of specific customer.| No |
 | developerToken | The developer token associated with the manager account that you use to grant access to the AdWords API.  You can choose to mark this field as a SecureString to store it securely, or store password in Azure Key Vault and let the copy activity pull from there when performing data copy - learn more from [Store credentials in Key Vault](store-credentials-in-key-vault.md). | Yes |
 | authenticationType | The OAuth 2.0 authentication mechanism used for authentication. ServiceAuthentication can only be used on self-hosted IR. <br/>Allowed values are: **ServiceAuthentication**, **UserAuthentication** | Yes |
 | refreshToken | The refresh token obtained from Google for authorizing access to AdWords for UserAuthentication. You can choose to mark this field as a SecureString to store it securely, or store password in Azure Key Vault and let the copy activity pull from there when performing data copy - learn more from [Store credentials in Key Vault](store-credentials-in-key-vault.md). | No |
@@ -90,32 +93,34 @@ The following properties are supported for Google AdWords linked service:
     "properties": {
         "type": "GoogleAdWords",
         "typeProperties": {
-            "clientCustomerID" : "<clientCustomerID>",
-            "developerToken": {
-                "type": "SecureString",
-                "value": "<developerToken>"
-            },
-            "authenticationType" : "ServiceAuthentication",
-            "refreshToken": {
-                "type": "SecureString",
-                "value": "<refreshToken>"
-            },
-            "clientId": {
-                "type": "SecureString",
-                "value": "<clientId>"
-            },
-            "clientSecret": {
-                "type": "SecureString",
-                "value": "<clientSecret>"
-            },
-            "email" : "<email>",
-            "keyFilePath" : "<keyFilePath>",
-            "trustedCertPath" : "<trustedCertPath>",
-            "useSystemTrustStore" : true,
+            "connectionProperties": {
+                "clientCustomerID": "<clientCustomerID>",
+                "loginCustomerID": "<loginCustomerID>",
+                "developerToken": {
+                    "type": "SecureString",
+                    "value": "<developerToken>"
+                },
+                "authenticationType": "ServiceAuthentication",
+                "refreshToken": {
+                    "type": "SecureString",
+                    "value": "<refreshToken>"
+                },
+                "clientId": {
+                    "type": "SecureString",
+                    "value": "<clientId>"
+                },
+                "clientSecret": {
+                    "type": "SecureString",
+                    "value": "<clientSecret>"
+                },
+                "email": "<email>",
+                "keyFilePath": "<keyFilePath>",
+                "trustedCertPath": "<trustedCertPath>",
+                "useSystemTrustStore": true,
+            }
         }
     }
 }
-
 ```
 
 ## Dataset properties

articles/data-factory/connector-troubleshoot-google-adwords.md

@@ -17,22 +17,24 @@ ms.custom: has-adal-ref, synapse
 
 This article provides suggestions to troubleshoot common problems with the Google AdWords connector in Azure Data Factory and Azure Synapse.
 
-## Error code:
+## Migrate to the new version of Google AdWords API
 
-- **Message**:
+- **Symptoms**
 
-- **Cause**: 
+    You see a hint on the Google AdWords linked service configuration page. It reminds you to upgrade your linked service to a newer version before the legacy API is deprecated by Google. 
 
-    Due to the sunset of Google AdWords API by April 27, 2022, you are recommended to migrate to the new version of Google AdWords API before the starting date April 27, 2022, and connection will start to fail because of the deprecation of Google AdWords API (see this [link](https://ads-developers.googleblog.com/2021/04/upgrade-to-google-ads-api-from-adwords.html)). Migration steps:
+- **Cause** 
+
+    Due to the sunset of Google AdWords API by April 27, 2022, you are recommended to migrate to the new version of Google Ads API before the date **April 27, 2022**, and connection will start to fail because of the deprecation of Google AdWords API (see this [link](https://ads-developers.googleblog.com/2021/04/upgrade-to-google-ads-api-from-adwords.html)). Migration steps:
 
-    1. Open your Google AdWords connector linked service.
-    2. Edit the linked service and choose the new API version.
+    1. Open your Google AdWords connector linked service configuration page.
+    2. Edit the linked service and choose the new API version (select **Google Ads**).
 
        :::image type="content" source="media/connector-troubleshoot-guide/update-google-adwords-linked-service.png" alt-text="Screenshot of updating the linked service configuration for Google AdWords.":::
 
     3. Apply the changes.
 
-- **Known issues and recommendations**:  
+- **Known issues and recommendations**  
 
     1. The new Google AdWords API doesn't provide a migration plan for below reports/tables:
         a. AD_CUSTOMIZERS_FEED_ITEM_REPORT
@@ -47,7 +49,7 @@ This article provides suggestions to troubleshoot common problems with the Googl
         j. MARKETPLACE_PERFORMANCE_REPORT
         k. TOP_CONTENT_PERFORMANCE_REPORT
 
-    2. The syntax for Google AdWords query language is similar to AWQL from the AdWords API, but not identical. You can refer this [document](https://developers.google.com/google-ads/api/docs/migration/querying) for more details.  
+    2. The syntax for Google Ads query language is similar to AWQL from the AdWords API, but not identical. You can refer this [document](https://developers.google.com/google-ads/api/docs/migration/querying) for more details.  
 
 
 ## Next steps