Profile Filter Links: update

Autorisierung erforderlich

Bestehenden Profilfilterlink aktualisieren. Jetzt ausprobieren oder Beispiel ansehen

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 Die Konto-ID, zu der der Link zum Profilfilter gehört.
linkId string ID des zu aktualisierenden Profilfilterlinks.
profileId string Profil-ID, zu der der Filterlink gehört
webPropertyId string Web-Property-ID, zu der der Link zum Profilfilter 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 Links zum Profilfilter mit den folgenden Eigenschaften an:

Attributname 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 (d.h. Auflisten und Abrufen) beginnt der Rang immer bei 1.

Für Schreibvorgänge (d.h. Erstellen, Aktualisieren oder Löschen) können Sie einen Wert zwischen 0 und 255 (jeweils einschließlich 0, 255) angeben. Wenn Sie einen Link am Ende der Liste einfügen möchten, geben Sie entweder keinen Rang an oder legen Sie einen Rang auf eine Zahl fest, die größer als der höchste Rang in der Liste ist. Wenn Sie einen Link an den Anfang der Liste setzen möchten, geben Sie einen Rang an, der kleiner oder gleich 1 ist. Durch den neuen Link werden alle vorhandenen Filter mit dem gleichen oder einem niedrigeren Rang in der Liste nach unten verschoben. Nachdem der Link eingefügt/aktualisiert/gelöscht wurde, werden alle Profilfilterlinks ab 1 neu nummeriert.

 Bearbeitbar

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Ressource für Profilfilterlinks 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))

Testen!

Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen. Alternativ können Sie den eigenständigen Explorer ausprobieren.