Autorisation requise
Met à jour une association webProperty-Google Ads existante. Essayez maintenant ou consultez un exemple.
Requête
Requête HTTP
PUT https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId
Paramètres
Nom du paramètre | Valeur | Description |
---|---|---|
Paramètres de chemin d'accès | ||
accountId |
string |
Identifiant du compte auquel appartient la propriété Web donnée. |
webPropertyAdWordsLinkId |
string |
propriété Web-ID d'association Google Ads. |
webPropertyId |
string |
ID de la propriété Web pour laquelle récupérer l'association à Google Ads. |
L'autorisation
Une autorisation est requise pour cette requête. Celle-ci doit inclure le champ d'application suivant (en savoir plus sur le processus d'authentification et d'autorisation).
Champ d'application |
---|
https://www.googleapis.com/auth/analytics.edit |
Corps de la requête
Dans le corps de la requête, indiquez une ressource "Associations Google Ads" avec les propriétés suivantes:
Nom de propriété | Valeur | Description | Notes |
---|---|---|---|
Propriétés obligatoires | |||
adWordsAccounts[] |
list |
Une liste des comptes client Google Ads. Il ne peut pas s'agir de comptes CM. Ce champ est obligatoire lorsque vous créez une association à Google Ads. Ce champ est obligatoire. | accessible en écriture |
adWordsAccounts[].customerId |
string |
Numéro client. Ce champ est obligatoire lorsque vous créez une association à Google Ads. | |
name |
string |
Nom du lien. Ce champ est obligatoire lorsque vous créez une association à Google Ads. | accessible en écriture |
Réponse
Lorsque cette méthode fonctionne, elle renvoie une ressource d'associations à Google Ads dans le corps de la réponse.
Exemples
Remarque : Les langages de programmation compatibles ne figurent pas tous dans les exemples de code présentés pour cette méthode (consultez la page Bibliothèques clientes pour obtenir la liste des langages compatibles).
Java
Utilise la bibliothèque cliente Java.
/* * Note: this code assumes you have an authorized Analytics service object. * See the Google Ads Links Developer Guide for details. */ /* * This request updates an existing Google Ads Link. */ // Construct a list of AdWordsAccounts. AdWordsAccount adWordsAccount = new AdWordsAccount(); adWordsAccount.setCustomerId("123-456-7890"); List<AdWordsAccount> adWordsAccounts = Arrays.asList(adWordsAccount); // Construct the body of the request. EntityAdWordsLink adWordsLink = new EntityAdWordsLink(); adWordsLink.setAdWordsAccounts(adWordsAccounts); adWordsLink.setName("Google Ads Link"); try{ analytics.management().webPropertyAdWordsLinks().update("123456", "UA-123456-1", "AABBCCDDEEFFGG", adWordsLink).execute(); } catch (GoogleJsonResponseException e) { System.err.println("There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); }
PHP
Utilise la bibliothèque cliente PHP
/** * Note: This code assumes you have an authorized Analytics service object. * See the Google Ads Links Developer Guide for details. */ /** * This request updates an existing Google Ads Link. */ // Construct an Google Ads account object. $adWordsAccount = new Google_Service_Analytics_AdWordsAccount(); $adWordsAccount->setCustomerId("123-456-7890"); // Construct the body of the request. $adWordsLink = new Google_Service_Analytics_EntityAdWordsLink(); $adWordsLink->setName('Google Ads Link'); $adWordsLink->setAdWordsAccounts(array($adWordsAccount)); try { $analytics->management_webPropertyAdWordsLinks->update('123456', 'UA-123456-1', 'AABBCCDDEEFFGG', $adWordsLink); } catch (apiServiceException $e) { print 'There was an Analytics API service error ' . $e->getCode() . ':' . $e->getMessage(); } catch (apiException $e) { print 'There was a general API error ' . $e->getCode() . ':' . $e->getMessage(); }
Python
Utilise la bibliothèque cliente Python
# Note: This code assumes you have an authorized Analytics service object. # See the Google Ads Links Developer Guide for details. # This request updates an existing Google Ads Link. try: analytics.management().webPropertyAdWordsLinks().update( accountId='123456', webPropertyId='UA-123456-1', webPropertyAdWordsLinkId='AABBCCDDEEFFGG', body={ 'adWordsAccounts': [ { 'customerId': '123-456-7890' } ], 'name': 'Google Ads Link' } ).execute() except TypeError, error: # Handle errors in constructing a query. print 'There was an error in constructing your query : %s' % error except HttpError, error: # Handle API errors. print ('There was an API error : %s : %s' % (error.resp.status, error.resp.reason))
JavaScript
Utilise la bibliothèque cliente JavaScript.
/* * Note: This code assumes you have an authorized Analytics client object. * See the Google Ads Links Developer Guide for details. */ /* * This request updates an existing Google Ads Link. */ function updateAdWordsLink() { var request = gapi.client.analytics.management.webPropertyAdWordsLinks.update( { 'accountId': '123456', 'webPropertyId': 'UA-123456-1', 'webPropertyAdWordsLinks': '11112222233334444', 'resource': { 'adWordsAccounts': [ { 'customerId': '123-456-7890'} ], 'name': 'Updated Google Ads Link' } }); request.execute(function (response) { // Handle the response. }); }
Essayer
Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse. Vous pouvez également utiliser la version autonome de l'explorateur.