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	Numéro du compte pour lequel un lien de filtre de profil doit être créé.
profileId	string	ID du profil pour lequel créer un lien de filtre.
webPropertyId	string	ID du site Web pour lequel créer un lien de filtre de profil.

L'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).

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	Notes
Propriétés obligatoires
filterRef.id	string	Identifiant 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 de lecture seule (c'est-à-dire list et get), le classement 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 rang ou de niveau inférieur dans 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 "Liens de filtre de profil" 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 la version autonome de l'explorateur.