Profile Filter Links: update

Autorisation requise

Mettez à jour un lien de filtre de profil existant. Essayer maintenant ou voir un exemple

Demande

Requête HTTP

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

Paramètres

Nom du paramètre Value Description
Paramètres de chemin d'accès
accountId string Identifiant du compte auquel appartient le lien du filtre de profil.
linkId string ID du lien du filtre de profil à mettre à jour.
profileId string ID du profil auquel le lien de filtre appartient
webPropertyId string ID de la propriété Web à laquelle appartient le lien du 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 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 updates an existing 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().update("123456",
    "UA-123456-1", "7654321", "11223344", 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 updates an existing profile filter link.
try:
  analytics.management().profileFilterLinks().update(
      accountId='123456',
      webPropertyId='UA-123456-1',
      profileId='7654321',
      linkId='11223344',
      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.