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.