Merge pull request #189710 from Clare-Zheng82/0222-Update_Google_AdWords_connector_docs

Update Google AdWords connector docs

Author: ttorble

articles/data-factory/TOC.yml

@@ -1051,6 +1051,8 @@ items:
         href: connector-troubleshoot-dynamics-dataverse.md
       - name: FTP, SFTP, and HTTP
         href: connector-troubleshoot-ftp-sftp-http.md
+      - name: Google AdWords
+        href: connector-troubleshoot-google-adwords.md          
       - name: Hive
         href: connector-troubleshoot-hive.md  
       - name: Oracle

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
@@ -63,12 +63,18 @@ The following sections provide details about properties that are used to define
 
 ## Linked service properties
 
+> [!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#migrate-to-the-new-version-of-google-ads-api) for detailed migration steps and recommendations. Please make sure the migration to be done before **April 27, 2022**.  
+
 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 |
@@ -87,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

@@ -0,0 +1,65 @@
+---
+title: Troubleshoot the Google AdWords connector
+titleSuffix: Azure Data Factory & Azure Synapse
+description: Learn how to troubleshoot issues with the Google AdWords connector in Azure Data Factory and Azure Synapse Analytics. 
+author: jianleishen
+ms.service: data-factory
+ms.subservice: data-movement
+ms.topic: troubleshooting
+ms.date: 02/23/2022
+ms.author: jianleishen
+ms.custom: has-adal-ref, synapse
+---
+
+# Troubleshoot the Google AdWords connector in Azure Data Factory and Azure Synapse
+
+[!INCLUDE[appliesto-adf-asa-md](includes/appliesto-adf-asa-md.md)]
+
+This article provides suggestions to troubleshoot common problems with the Google AdWords connector in Azure Data Factory and Azure Synapse.
+
+## Migrate to the new version of Google Ads API
+
+- **Symptoms**
+
+    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. 
+
+- **Cause** 
+
+    Due to the sunset of Google AdWords API by **April 27, 2022**, you are recommended to migrate your existing linked service to the new version of Google Ads API before the date. Starting **April 27, 2022**, 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 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**  
+
+    1. The new Google Ads API doesn't provide a migration plan for below reports/tables:  
+        a. AD_CUSTOMIZERS_FEED_ITEM_REPORT  
+        b. CAMPAIGN_GROUP_PERFORMANCE_REPORT  
+        c. CAMPAIGN_NEGATIVE_KEYWORDS_PERFORMANCE_REPORT  
+        d. CAMPAIGN_NEGATIVE_LOCATIONS_REPORT  
+        e. CAMPAIGN_NEGATIVE_PLACEMENTS_PERFORMANCE_REPORT  
+        f. CREATIVE_CONVERSION_REPORT  
+        g. CRITERIA_PERFORMANCE_REPORT  
+        h. FINAL_URL_REPORT  
+        i. KEYWORDLESS_CATEGORY_REPORT  
+        j. MARKETPLACE_PERFORMANCE_REPORT  
+        k. TOP_CONTENT_PERFORMANCE_REPORT  
+
+    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
+
+For more troubleshooting help, try these resources:
+
+- [Connector troubleshooting guide](connector-troubleshoot-guide.md)
+- [Data Factory blog](https://azure.microsoft.com/blog/tag/azure-data-factory/)
+- [Data Factory feature requests](/answers/topics/azure-data-factory.html)
+- [Azure videos](https://azure.microsoft.com/resources/videos/index/?sort=newest&services=data-factory)
+- [Microsoft Q&A page](/answers/topics/azure-data-factory.html)
+- [Stack Overflow forum for Data Factory](https://stackoverflow.com/questions/tagged/azure-data-factory)
+- [Twitter information about Data Factory](https://twitter.com/hashtag/DataFactory)