Links de filtro do perfil: insert

Requer autorização

Cria um novo link de filtro de perfil. Faça um teste agora ou veja um exemplo.

Solicitação

Solicitação HTTP

POST https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de caminho
accountId string ID da conta para a qual criar o link de filtro de perfil.
profileId string ID do perfil para o qual criar o link de filtro.
webPropertyId string ID da propriedade da Web para a qual criar o link de filtro de 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 obrigatórias
filterRef.id string ID do filtro. gravável
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 creates a new 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().insert("123456",
    "UA-123456-1", "7654321", 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 creates a new profile filter link.
try:
  analytics.management().profileFilterLinks().insert(
      accountId='123456',
      webPropertyId='UA-123456-1',
      profileId='7654321',
      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.