Cette page a été traduite par l'API Cloud Translation.

Profile Filter Links: insert

Créer un lien de filtre de profil. Essayer maintenant ou voir un exemple

Demande

Requête HTTP

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

Paramètres

Nom du paramètre	Value	Description
Paramètres de chemin d'accès
`accountId`	`string`	ID du compte pour lequel vous souhaitez 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 la propriété Web pour laquelle créer un lien de filtre de profil.

Autorisation

Cette requête nécessite une autorisation ayant le champ d'application suivant (en savoir plus sur l'authentification et l'autorisation).

Portée
`https://www.googleapis.com/auth/analytics.edit`

Corps de la requête

Dans le corps de la requête, indiquez une ressource "Filters Link Links" (Filtre de liens de profil) avec les propriétés suivantes:

Nom de propriété	Value	Description	Remarques
Propriétés obligatoires
`filterRef.id`	`string`	ID du filtre.	accessible en écriture
Propriétés facultatives
`rank`	`integer`	Classement du filtre de ce profil par rapport aux autres filtres associés au même profil. Pour les opérations en lecture seule (c'est-à-dire les opérations de liste et d'obtention), 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, [0, 255]. Pour insérer un lien à la fin de la liste, ne spécifiez pas de rang ou ne définissez pas de rang supérieur à celui qui est le plus élevé. 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 de même niveau ou de niveau inférieur dans la liste. Une fois le lien inséré/mis à jour/supprimé, tous les liens de filtre de profil sont renumérotés à partir de 1.	accessible en écriture

Réponse

Lorsque cette méthode fonctionne, elle renvoie une ressource "Link filter" (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 essayer l'explorateur autonome.