Enlaces de AdWords: update

Requiere autorización

Actualiza un enlace de propiedad web-AdWords. 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 de propiedad web-AdWords.
webPropertyId string ID de propiedad web para el que se recuperará el enlace de AdWords.

Autorización

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

Alcance
https://www.googleapis.com/auth/analytics.edit

Cuerpo de la solicitud

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

Nombre de propiedad Valor Descripción Notas
Propiedades obligatorias
adWordsAccounts[] list Lista de cuentas cliente de AdWords. No pueden ser cuentas de MCC. Este campo es obligatorio al crear un enlace de AdWords. No puede estar vacío. editable
adWordsAccounts[].customerId string ID de cliente. Este campo es obligatorio al crear un enlace de AdWords.
name string Nombre del enlace. Este campo es obligatorio al crear un enlace de AdWords. editable

Respuesta

Si se realiza correctamente, este método devuelve un recurso Enlaces de AdWords 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 AdWords Links Developer Guide for details.
 */

/*
 * This request updates an existing AdWords 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("AdWords 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 AdWords Links Developer Guide for details.
 */

/**
 * This request updates an existing AdWords Link.
 */

// Construct an AdWords 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('AdWords 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 AdWords Links Developer Guide for details.

# This request updates an existing AdWords Link.
try:
  analytics.management().webPropertyAdWordsLinks().update(
      accountId='123456',
      webPropertyId='UA-123456-1',
      webPropertyAdWordsLinkId='AABBCCDDEEFFGG',
      body={
          'adWordsAccounts': [
              {
                  'customerId': '123-456-7890'
              }
          ],
          'name': 'AdWords 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 AdWords Links Developer Guide for details.
 */

/*
 * This request updates an existing AdWords 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 AdWords 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.