Requer autorização
Atualiza um link de filtro do perfil existente. Faça um teste agora ou veja um exemplo.
Solicitação
Solicitação HTTP
PUT https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId
Parâmetros
Nome do parâmetro | Valor | Descrição |
---|---|---|
Parâmetros de caminho | ||
accountId |
string |
ID da conta à qual pertence o link de filtro do perfil. |
linkId |
string |
ID do link de filtro do perfil a ser atualizado. |
profileId |
string |
ID do perfil ao qual pertence o link de filtro. |
webPropertyId |
string |
ID da propriedade da Web à qual pertence o link de filtro do perfil. |
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 um recurso de links de filtro do perfil com as seguintes propriedades:
Nome da propriedade | Valor | Descrição | Observações |
---|---|---|---|
Propriedades opcionais | |||
rank |
integer |
A classificação desse link de filtro do perfil em relação aos outros filtros vinculados à mesma propriedade. Para as operações somente leitura (isto é, "list" e "get"), a classificação sempre começa com 1. Para as operações de gravação (isto é, create, update ou delete), você pode especificar um valor entre 0 e 255 (inclusive), [0, 255]. Para inserir um link no final da lista, não especifique uma classificação nem a defina como um número maior que a classificação mais alta da lista. Para inserir um link no início da lista, especifique uma classificação menor ou igual a 1. O novo link moverá para baixo na lista todos os filtros existentes com a mesma classificação ou uma mais baixa. Depois que o link for inserido/atualizado/excluído, todos os links de filtro do perfil serão renumerados a partir de 1. |
gravável |
Resposta
Se for bem-sucedido, esse método retornará um recurso de links de filtro do perfil 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 Filters Developer Guide for details. */ /* * This request updates an existing profile filter link. */ // Construct the filter reference. FilterRef filterRef = new FilterRef(); filterRef.setId("1223334444"); // Construct the body of the request. ProfileFilterLink body = new ProfileFilterLink(); body.setFilterRef(filterRef); try { analytics.management().profileFilterLinks().update("123456", "UA-123456-1", "7654321", "11223344", body).execute(); } catch (GoogleJsonResponseException e) { System.err.println("There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); }
Python
Usa a biblioteca cliente de Python.
# Note: This code assumes you have an authorized Analytics service object. # See the Filters Developer Guide for details. # This request updates an existing profile filter link. try: analytics.management().profileFilterLinks().update( accountId='123456', webPropertyId='UA-123456-1', profileId='7654321', linkId='11223344', body={ 'filterRef': { 'id': '1223334444' } } ).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))
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.