Profile Filter Links: update

Requiere autorización

Actualiza un vínculo existente de filtro de perfil. Pruébalo ahora y ve un ejemplo.

Solicitud

Solicitud HTTP

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

Parámetros

Nombre del parámetro	Valor	Descripción
Parámetros de ruta de acceso
`accountId`	`string`	ID de la cuenta al que pertenece el vínculo del filtro de perfil
`linkId`	`string`	ID del vínculo de filtro de perfil que se actualizará.
`profileId`	`string`	ID de perfil al que pertenece el vínculo de filtro
`webPropertyId`	`string`	ID de propiedad web al que pertenece el vínculo del filtro de perfil

Autorización

Esta solicitud requiere autorización con el siguiente alcance (obtén más información sobre la autenticación y la autorización).

Alcance
`https://www.googleapis.com/auth/analytics.edit`

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporciona un recurso de vínculos de filtros de perfiles con las siguientes propiedades:

Nombre de la propiedad Valor Descripción Notas

Nombre de la propiedad	Valor	Descripción	Notas
Propiedades opcionales
`rank`	`integer`	La clasificación del vínculo de este filtro de perfil en relación con los otros filtros vinculados al mismo perfil Para las operaciones de solo lectura (es decir, list y get), la clasificación siempre comienza en 1. Para las operaciones de escritura (es decir, crear, actualizar o borrar), puedes especificar un valor entre 0 y 255 inclusive, [0, 255]. Para insertar un vínculo al final de la lista, no especifiques una clasificación ni establezcas una clasificación en un número superior a la clasificación más grande de la lista. Para insertar un vínculo al principio de la lista, especifica una clasificación menor o igual que 1. La nueva vinculación moverá todos los filtros existentes con la misma clasificación o una clasificación inferior hacia abajo en la lista. Después de insertar, actualizar o borrar el vínculo, todos los vínculos del filtro de perfil cambiarán de numeración a partir del 1.	admite escritura

Propiedades opcionales

rank

integer

La clasificación del vínculo de este filtro de perfil en relación con los otros filtros vinculados al mismo perfil

Para las operaciones de solo lectura (es decir, list y get), la clasificación siempre comienza en 1.

Para las operaciones de escritura (es decir, crear, actualizar o borrar), puedes especificar un valor entre 0 y 255 inclusive, [0, 255]. Para insertar un vínculo al final de la lista, no especifiques una clasificación ni establezcas una clasificación en un número superior a la clasificación más grande de la lista. Para insertar un vínculo al principio de la lista, especifica una clasificación menor o igual que 1. La nueva vinculación moverá todos los filtros existentes con la misma clasificación o una clasificación inferior hacia abajo en la lista. Después de insertar, actualizar o borrar el vínculo, todos los vínculos del filtro de perfil cambiarán de numeración a partir del 1.

admite escritura

Respuesta

Si se aplica correctamente, este método muestra un recurso de vínculos de filtros de perfil en el cuerpo de la respuesta.

Ejemplos

Nota: Los ejemplos de código disponibles para este método no representan todos los lenguajes de programación admitidos (consulta la página de bibliotecas cliente para consultar una lista de lenguajes admitidos).

Java

Usa la 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 la 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))

Pruébalo

Usa el Explorador de APIs que aparece a continuación para llamar a este método con los datos en tiempo real y ver la respuesta. También puedes probar el Explorador independiente.