Profile Filter Links: insert

Richiede l'autorizzazione

Link Crea un nuovo filtro profilo. Prova subito o visualizza un esempio.

Richiesta

Richiesta HTTP

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

Parametri

Nome del parametro	Valore	Descrizione
Parametri del percorso
accountId	string	ID account per il quale creare il link al filtro del profilo.
profileId	string	ID profilo per il quale creare il link al filtro.
webPropertyId	string	ID proprietà web per cui creare il link al filtro del profilo.

Autorizzazione

Questa richiesta richiede l'autorizzazione con il seguente ambito (scopri di più su autenticazione e autorizzazione).

Ambito
https://www.googleapis.com/auth/analytics.edit

Corpo della richiesta

Nel corpo della richiesta, fornisci una risorsa Link filtro profilo con le seguenti proprietà:

Nome proprietà	Valore	Descrizione	Note
Proprietà obbligatorie
filterRef.id	string	ID filtro.	scrivibile
Proprietà facoltative
rank	integer	La posizione di questo link al filtro del profilo rispetto agli altri filtri collegati allo stesso profilo. Per le operazioni di sola lettura (ovvero, list e get), il ranking inizia sempre da 1. Per le operazioni di scrittura (ovvero creazione, aggiornamento o eliminazione), puoi specificare un valore compreso tra 0 e 255 inclusi, [0, 255]. Per inserire un link alla fine dell'elenco, non specificare un ranking o impostare un ranking su un numero maggiore di quello più alto dell'elenco. Per inserire un link all'inizio dell'elenco, specifica un ranking inferiore o uguale a 1. Il nuovo link sposterà tutti i filtri esistenti con lo stesso ranking o ranking inferiore nell'elenco. Una volta che il link è stato inserito/aggiornato/eliminato, tutti i link del filtro del profilo verranno rinnovati a partire da 1.	scrivibile

Risposta

Se l'esito è positivo, questo metodo restituisce una risorsa Link filtro profilo nel corpo della risposta.

Esempi

Nota: gli esempi di codice disponibili per questo metodo non rappresentano tutti i linguaggi di programmazione supportati (consulta la pagina relativa alle librerie client per un elenco dei linguaggi supportati).

Java

Utilizza la libreria client 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

Utilizza la libreria client 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))

Prova.

Utilizza Explorer API di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta. In alternativa, prova a utilizzare Explorer in modalità autonoma.