Requiere autorización
Actualiza una vinculación existente entre propiedades web y Google Ads. Pruébalo ahora y ve un ejemplo.
Solicitud
Solicitud HTTP
PUT https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId
Parámetros
Nombre del parámetro | Valor | Descripción |
---|---|---|
Parámetros de ruta de acceso | ||
accountId |
string |
Es el ID de la cuenta a la que pertenece la propiedad web determinada. |
webPropertyAdWordsLinkId |
string |
Propiedad web - ID de vinculación de Google Ads |
webPropertyId |
string |
ID de propiedad web para el que se recuperará la vinculación de Google Ads. |
Autorización
Esta solicitud requiere autorización con el siguiente alcance (obtén más información sobre la autenticación y la autorización).
Permiso |
---|
https://www.googleapis.com/auth/analytics.edit |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporciona un recurso de vínculos de Google Ads con las siguientes propiedades:
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
Propiedades obligatorias | |||
adWordsAccounts[] |
list |
Una lista de las cuentas de cliente de Google Ads. Estas no pueden ser cuentas de MCC. Este campo es obligatorio cuando se crea una vinculación de Google Ads. No puede estar vacío. | admite escritura |
adWordsAccounts[].customerId |
string |
ID de cliente. Este campo es obligatorio cuando se crea una vinculación de Google Ads. | |
name |
string |
Es el nombre del vínculo. Este campo es obligatorio cuando se crea una vinculación de Google Ads. | admite escritura |
Respuesta
Si se aplica correctamente, este método muestra un recurso de vinculaciones con 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 cliente para consultar una lista de lenguajes admitidos).
Java
Usa la biblioteca cliente de 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
Usa la biblioteca cliente de 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
Usa la biblioteca cliente de 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
Usa la biblioteca cliente de 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ébala
Usa el Explorador de APIs que aparece a continuación para llamar a este método con datos en tiempo real y ver la respuesta. También puedes probar el Explorador independiente.