Enlaces de Google Ads: update

Actualiza un enlace entre una propiedad web y una cuenta de Google Ads. Pruébalo ahora o consulta un ejemplo.

Solicitud

Solicitud HTTP

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

Parámetros

Nombre de parámetro	Valor	Descripción
Parámetros de ruta
`accountId`	`string`	ID de la cuenta a la que pertenece la propiedad web indicada.
`webPropertyAdWordsLinkId`	`string`	ID de enlace entre una propiedad web y una cuenta de Google Ads.
`webPropertyId`	`string`	ID de propiedad web para el que se obtendrá el enlace de Google Ads.

Autorización

Esta solicitud requiere autorización con el siguiente ámbito. Consulta más información sobre la autenticación y la autorización.

Ámbito
`https://www.googleapis.com/auth/analytics.edit`

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporciona un recurso Enlaces de Google Ads con las propiedades siguientes:

Nombre de la propiedad	Valor	Descripción	Notas
Propiedades obligatorias
`adWordsAccounts[]`	`list`	Lista de cuentas de cliente de Google Ads. No pueden ser cuentas de MCC. Es obligatorio completar este campo al crear un enlace de Google Ads. No puede estar vacío.	editable
`adWordsAccounts[].customerId`	`string`	ID de cliente. Es obligatorio completar este campo al crear un enlace de Google Ads.
`name`	`string`	Nombre del enlace. Es obligatorio completar este campo al crear un enlace de Google Ads.	editable

Respuesta

Si se realiza correctamente, este método devuelve un recurso Enlaces de Google Ads en el cuerpo de la respuesta.

Ejemplos

Nota: Los ejemplos de código disponibles para este método no representan todos los lenguajes de programación admitidos (consulta la página de bibliotecas de cliente para obtener una lista de los lenguajes admitidos).

Java

Utiliza la biblioteca de 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

Utiliza la biblioteca de 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

Utiliza la biblioteca de 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

Utiliza la biblioteca de 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. });
}

Pruébalo

Utiliza el siguiente explorador de APIs para llamar a este método con datos en tiempo real y ver la respuesta. También puedes probar el explorador independiente.