Google Ads Links: update

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Autorisation requise

Met à jour une association webProperty-Google Ads existante. Essayer maintenant ou voir un exemple

Demande

Requête HTTP

PUT https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId

Paramètres

Nom du paramètre Value 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.

Autorisation

Cette requête nécessite une autorisation ayant le champ d'application suivant (en savoir plus sur l'authentification et l'autorisation).

Portée
https://www.googleapis.com/auth/analytics.edit

Corps de la requête

Dans le corps de la requête, indiquez une ressource Liens Google Ads avec les propriétés suivantes:

Nom de propriété Value Description Remarques
Propriétés obligatoires
adWordsAccounts[] list Liste de comptes client Google Ads. Il ne peut pas s'agir de comptes CM. Ce champ est obligatoire lors de la création d'une association à Google Ads. Ce champ est obligatoire. accessible en écriture
adWordsAccounts[].customerId string Numéro client. Ce champ est obligatoire lors de la création d'une association à Google Ads.
name string Nom de l'association. Ce champ est obligatoire lors de la création d'une association à Google Ads. accessible en écriture

Réponse

Lorsque cette méthode fonctionne, elle renvoie une ressource "Liens 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 essayer l'explorateur autonome.