Profile Filter Links: insert

Autorisation requise

Créer un lien de filtre de profil. Essayez maintenant ou consultez un exemple.

Requête

Requête HTTP

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

Paramètres

Nom du paramètre Valeur Description
Paramètres de chemin d'accès
accountId string ID du compte pour lequel créer un lien de filtre de profil.
profileId string ID du profil pour lequel créer un lien de filtre.
webPropertyId string ID de site Web pour lequel créer un lien de filtre de profil.

Autorisation

Une autorisation est requise pour cette requête. Celle-ci doit inclure le champ d'application suivant (en savoir plus sur le processus d'authentification et d'autorisation).

Définition du champ d'application
https://www.googleapis.com/auth/analytics.edit

Corps de la requête

Dans le corps de la requête, fournissez une ressource "Profile Filter Links" avec les propriétés suivantes:

Nom de propriété Valeur Description Remarques
Propriétés obligatoires
filterRef.id string ID du filtre. accessible en écriture
Propriétés facultatives
rank integer Classement de ce lien de filtre de profil par rapport aux autres filtres associés au même profil.

Pour les opérations en lecture seule (c'est-à-dire list et get), le rang commence toujours à 1.

Pour les opérations d'écriture (création, mise à jour ou suppression), vous pouvez spécifier une valeur comprise entre 0 et 255 inclus, soit [0, 255]. Pour insérer un lien à la fin de la liste, ne spécifiez pas de rang ou définissez un rang sur un nombre supérieur au classement le plus élevé de la liste. Pour insérer un lien au début de la liste, spécifiez un rang inférieur ou égal à 1. Le nouveau lien déplacera tous les filtres existants de même niveau ou de classement inférieur vers le bas de la liste. Une fois le lien inséré, mis à jour ou supprimé, tous les liens des filtres de profil sont renumérotés à partir de 1.

accessible en écriture

Réponse

Lorsque cette méthode fonctionne, elle renvoie une ressource "Profile Filter Links" dans le corps de la réponse.

Exemples

Remarque : Les langages de programmation compatibles ne figurent pas tous dans les exemples de code présentés pour cette méthode (consultez la page Bibliothèques clientes pour obtenir la liste des langages compatibles).

Java

Utilise la bibliothèque 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

Utilise la bibliothèque 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))

Essayer

Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse. Vous pouvez également utiliser l'explorateur autonome.