Requiere autorización
Crea un enlace de propiedad web-AdWords. Pruébalo ahora o mira un ejemplo.
Solicitud
Solicitud HTTP
POST https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks
Parámetros
Nombre de parámetro | Valor | Descripción |
---|---|---|
Parámetros de ruta | ||
accountId |
string |
ID de la cuenta de Google Analytics para la que se creará el enlace. |
webPropertyId |
string |
ID de la propiedad web para la que se creará el enlace. |
Autorización
Esta solicitud requiere autorización con el siguiente ámbito. Obtén más información sobre la autenticación y las autorizaciones.
Ámbito |
---|
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. Es obligatorio completar este campo al crear un enlace de AdWords. No puede estar vacío. | editable |
adWordsAccounts[].customerId |
string |
ID de cliente. Es obligatorio completar este campo al crear un enlace de AdWords. | |
name |
string |
Nombre del enlace. Es obligatorio completar este campo 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 creates a new 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().insert("123456", "UA-123456-1", 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 creates a new 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->insert('123456', 'UA-123456-1', $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 creates a new AdWords Link. try: analytics.management().webPropertyAdWordsLinks().insert( accountId='123456', webPropertyId='UA-123456-1', 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 creates a new AdWords Link. */ function insertAdWordsLink() { var request = gapi.client.analytics.management.webPropertyAdWordsLinks.insert( { 'accountId': '123456', 'webPropertyId': 'UA-123456-1', 'resource': { 'adWordsAccounts': [ { 'customerId': '123-456-7890'} ], 'name': '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.