Requer autorização
Atualiza uma vinculação existente entre a propriedade da Web e o Google Ads. 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 Ads. |
webPropertyId |
string |
ID da propriedade da Web cuja vinculação ao Google Ads deverá ser recuperada. |
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 vinculações do Google Ads de acordo com as regras da semântica de patch, usando estas propriedades:
Nome da propriedade | Valor | Descrição | Observações |
---|---|---|---|
Propriedades opcionais | |||
adWordsAccounts[] |
list |
Uma lista de contas de clientes do Google Ads. Não podem ser contas da MCC. Este campo é obrigatório na criação de uma vinculação do Google Ads. Ele não pode ficar em branco. | gravável |
name |
string |
Nome da vinculação. Este campo é obrigatório na criação de uma vinculação do Google Ads. | gravável |
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 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
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 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
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 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
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 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. }); }
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.