Enlaces de filtros de perfiles: insert

Requiere autorización

Crea un nuevo enlace de filtro de perfil. Pruébalo ahora o consulta un ejemplo.

Solicitud

Solicitud HTTP

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

Parámetros

Nombre de parámetro Valor Descripción
Parámetros de ruta
accountId string ID de cuenta para el que se creará el enlace de filtro de perfil.
profileId string ID de perfil para el que se creará el enlace de filtro.
webPropertyId string ID de propiedad web para el que se creará el enlace de filtro de perfil.

Autorización

Esta solicitud requiere autorización con el siguiente ámbito. Obtén más información sobre la autenticación y la autorización.

Ámbito
https://www.googleapis.com/auth/analytics.edit

Cuerpo de la solicitud

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

Nombre de propiedad Valor Descripción Notas
Propiedades obligatorias
filterRef.id string ID de filtro. editable
Propiedades opcionales
rank integer La clasificación de este enlace de filtro de perfil en relación con los demás filtros enlazados al mismo perfil.

En el caso de las operaciones de solo lectura (por ejemplo, enumerar y obtener), la clasificación siempre empieza en 1.

En el caso de las operaciones de escritura (por ejemplo, crear, actualizar o suprimir), puedes especificar un valor entre 0 y 255 ambos incluidos, [0, 255]. Para insertar un enlace al final de la lista, no especifiques una clasificación ni configures una clasificación como un número superior a la clasificación más alta de la lista. Para insertar un enlace al principio de la lista, especifica una clasificación que sea menor o igual que 1. El nuevo enlace desplazará hacia abajo en la lista los filtros con una clasificación igual o inferior. Después de que el enlace se inserte, actualice o suprima, todos los enlaces de filtro de perfil se renumerarán a partir de 1.

editable

Respuesta

Si se realiza correctamente, este método devuelve un recurso Enlaces de filtro de perfiles 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 de cliente para obtener una lista de los lenguajes admitidos).

Java

Utiliza la biblioteca de cliente 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

Utiliza la biblioteca de cliente 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))

Pruébalo

Utiliza el siguiente explorador de APIs para llamar a este método con datos en tiempo real y ver la respuesta. También puedes probar el explorador independiente.