Enlaces de Google Ads: patch

Requiere autorización

Actualiza un enlace entre una propiedad web y una cuenta de Google Ads. Este método es compatible con la semántica de parches. Pruébalo ahora o consulta un ejemplo.

Solicitud

Solicitud HTTP

PATCH 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, indica las partes relevantes de un recurso Enlaces de Google Ads, según las reglas de la semántica de parches, con las propiedades siguientes:

Nombre de la propiedad	Valor	Descripción	Notas
Propiedades opcionales
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
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 compatibles (consulta la página de bibliotecas de cliente para obtener la lista de los lenguajes compatibles).

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 patches 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().patch("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 patches 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->patch('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 patches an existing Google Ads Link.
try:
  analytics.management().webPropertyAdWordsLinks().patch(
      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 patches an existing Google Ads Link.
 */
function patchAdWordsLink() {
  var request = gapi.client.analytics.management.webPropertyAdWordsLinks.patch(
    {
      'accountId': '123456',
      'webPropertyId': 'UA-123456-1',
      'webPropertyAdWordsLinks': '11112222233334444',
      'resource': {
        'adWordsAccounts': [ { 'customerId': '123-456-7890'} ],
        'name': 'Patched 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.