Profile Filter Links: update

Autorisierung erforderlich

Link zu einem vorhandenen Profilfilter aktualisieren. Probieren Sie es aus oder sehen Sie sich ein Beispiel an.

Anfragen

HTTP-Anfrage

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

Parameter

Parametername Wert Beschreibung
Pfadparameter
accountId string Konto-ID, zu der der Profilfilterlink gehört.
linkId string ID des Profilfilterlinks, der aktualisiert werden soll.
profileId string Profil-ID, zu der der Filterlink gehört
webPropertyId string Web-Property-ID, zu der der Profilfilterlink gehört

Autorisierung

Für diese Anfrage ist eine Autorisierung in folgendem Bereich erforderlich. Weitere Informationen zur Authentifizierung und Autorisierung

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

Anfragetext

Geben Sie im Anfragetext eine Ressource für Profilfilter-Links mit den folgenden Eigenschaften an:

Property-Name Wert Beschreibung Hinweise
Optionale Attribute
rank integer Der Rang dieses Profilfilterlinks im Verhältnis zu den anderen Filtern, die mit demselben Profil verknüpft sind.

Bei schreibgeschützten Vorgängen (z.B. list und get) beginnt der Rang immer bei 1.

Für Schreibvorgänge (d.h. Erstellungs-, Aktualisierungs- oder Löschvorgänge) können Sie einen Wert zwischen 0 und 255 (einschließlich [0, 255]) angeben. Um einen Link am Ende der Liste einzufügen, geben Sie entweder keinen Rang an oder stellen Sie einen Rang auf eine Zahl ein, die größer als der größte Rang in der Liste ist. Um einen Link am Anfang der Liste einzufügen, geben Sie einen Rang an, der kleiner oder gleich 1 ist. Durch den neuen Link werden alle vorhandenen Filter mit demselben oder einem niedrigeren Rang in der Liste nach unten verschoben. Nachdem der Link eingefügt/aktualisiert/gelöscht wurde, werden alle Profilfilter-Links ab 1 neu nummeriert.

Bearbeitbar

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Ressource vom Typ "Profilfilter-Links" im Antworttext zurückgegeben.

Beispiele

Hinweis: Bei den für diese Methode verfügbaren Codebeispielen sind nicht alle unterstützten Programmiersprachen vertreten. Eine Liste der unterstützten Sprachen finden Sie auf der Seite für Clientbibliotheken.

Java

Verwendet die Java-Clientbibliothek.

/*
 * 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

Verwendet die Python-Clientbibliothek.

# 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))

Jetzt testen

Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen. Probieren Sie alternativ den eigenständigen Explorer aus.