Links do Google AdWords: patch

Requer autorização

Atualiza um link existente entre a propriedade da Web e o Google AdWords. Esse método é compatível com a semântica de patch. Faça um teste agora ou veja um exemplo.

Solicitação

Solicitação HTTP

PATCH 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 AdWords.
webPropertyId string ID da propriedade da Web para a qual recuperar o link do Google AdWords.

Autorização

Essa solicitação requer uma autorização com o escopo a seguir (mais informações sobre autenticação e autorização).

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

Corpo da solicitação

No corpo da solicitação, forneça as partes relevantes de um recurso de links do Google AdWords, de acordo com as regras da semântica de patch, com estas propriedades:

Nome da propriedade Valor Descrição Observações
Propriedades opcionais
adWordsAccounts[] list Uma lista das contas de clientes do Google AdWords. Não podem ser contas da MCC (Minha central de clientes). Este campo é obrigatório na criação de um link do Google AdWords. Ele não pode ficar em branco. gravável
name string Nome do link. Este campo é obrigatório na criação de um link do Google AdWords. gravável

Resposta

Se for bem-sucedido, esse método retornará um recurso de links do Google AdWords 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 AdWords Links Developer Guide for details.
 */

/*
 * This request patches 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().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

Usa a biblioteca cliente de PHP.

/**
 * Note: This code assumes you have an authorized Analytics service object.
 * See the AdWords Links Developer Guide for details.
 */

/**
 * This request patches 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->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

Usa a biblioteca cliente de Python.

# Note: This code assumes you have an authorized Analytics service object.
# See the AdWords Links Developer Guide for details.

# This request patches an existing AdWords Link.
try:
  analytics.management().webPropertyAdWordsLinks().patch(
      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

Usa a biblioteca cliente de JavaScript.

/*
 * Note: This code assumes you have an authorized Analytics client object.
 * See the AdWords Links Developer Guide for details.
 */

/*
 * This request patches an existing AdWords 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 AdWords Link'
      }
    });
  request.execute(function (response) { // Handle the response. });
}

Faça um teste

Use o APIs Explorer abaixo para chamar esse método em dados ativos e ver a resposta. Como alternativa, teste o Explorador independente.