Google Ads Links: get

Requer autorização

Retorna uma vinculação entre a propriedade da Web e o Google Ads à qual o usuário tem acesso. Faça um teste agora ou veja um exemplo.

Solicitação

Solicitação HTTP

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

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de caminho
accountId string ID da conta à qual a propriedade da Web específica pertence.
webPropertyAdWordsLinkId string ID do link entre a propriedade da Web e o Google Ads.
webPropertyId string ID da propriedade da Web cuja vinculação ao Google Ads deverá ser recuperada.

Autorização

Esta solicitação requer autorização com pelo menos um dos seguintes escopos (leia mais sobre autenticação e autorização).

Escopo
https://www.googleapis.com/auth/analytics.edit
https://www.googleapis.com/auth/analytics.readonly

Corpo da solicitação

Não forneça um corpo de solicitação com este método.

Resposta

Se for bem-sucedido, esse método retornará um recurso de vinculação do Google Ads no corpo da resposta.

Exemplos

Observação: os exemplos de código disponíveis para esse método não representam todas as linguagens de programação compatíveis. Consulte a página de bibliotecas cliente para ver uma lista de linguagens compatíveis.

Java

Usa a 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 gets an existing Google Ads Link.
 */
try{
  EntityAdWordsLink adWordsLink = analytics.management().
      webPropertyAdWordsLinks().get("123456",
          "UA-123456-1", "AABBCCDDEEFFGG").execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

PHP

Usa a 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 gets an existing Google Ads Link.
 */

try {
  $adWordsLink = $analytics->management_webPropertyAdWordsLinks->get(
      '123456', 'UA-123456-1', 'AABBCCDDEEFFGG');

} 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 a 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 gets an existing Google Ads Link.
try:
  adWordsLink = analytics.management().webPropertyAdWordsLinks().get(
      accountId='123456',
      webPropertyId='UA-123456-1',
      webPropertyAdWordsLinkId='AABBCCDDEEFFGG'
  ).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 a 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 gets an existing Google Ads Link.
 */
function getAdWordsLink() {
  var request = gapi.client.analytics.management.webPropertyAdWordsLinks.get({
    'accountId': '123456',
    'webPropertyId': 'UA-123456-1',
    'webPropertyAdWordsLinkId': '11112222233334444'
  });
  request.execute(function (response) { // Handle the response. });
}

Confira!

Use o APIs Explorer abaixo para chamar esse método para dados ativos e ver a resposta. Se você preferir, teste o Explorador independente.