Profile Filter Links: insert

Wymaga autoryzacji

Link do tworzenia nowego filtra profilu. Wypróbuj teraz lub zobacz przykład.

Prośba

Żądanie HTTP

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

Parametry

Nazwa parametru	Wartość	Opis
Parametry ścieżki
accountId	string	Identyfikator konta, dla którego chcesz utworzyć link filtra profilu.
profileId	string	Identyfikator profilu, dla którego chcesz utworzyć link filtra.
webPropertyId	string	Identyfikator usługi internetowej, dla której ma zostać utworzony link do filtrowania profilu.

Upoważnienie

To żądanie wymaga autoryzacji z tego zakresu (więcej informacji o uwierzytelnianiu i autoryzacji).

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

Treść żądania

W treści żądania podaj zasób linków do filtrów profilu z tymi właściwościami:

nazwa usługi,	Wartość	Opis	Uwagi
Właściwości wymagane
filterRef.id	string	Identyfikator filtra.	z możliwością zapisu
Właściwości opcjonalne
rank	integer	Pozycja tego linku filtra profilu w stosunku do innych filtrów połączonych z tym profilem. W przypadku operacji tylko do odczytu (np. list i pobierania) pozycja zawsze zaczyna się od 1. W przypadku operacji zapisu (tj. tworzenia, aktualizacji lub usuwania) możesz podać wartość od 0 do 255 włącznie i [0–255]. Aby wstawić link na końcu listy, nie określaj pozycji ani nie ustawiaj jej na liczbę większą niż najwyższa pozycja na liście. Aby wstawić link na początku listy, określ pozycję mniejszą lub równą 1. Nowy link spowoduje przeniesienie w dół listy wszystkich istniejących filtrów o tej samej lub niższej pozycji. Po wstawieniu/zaktualizowaniu/usunięciu wszystkich linków do filtrów profili zostaną zmienione numery, począwszy od 1.	z możliwością zapisu

Odpowiedź

Jeśli operacja się uda, ta metoda zwróci w treści odpowiedzi zasób linków do filtrów profilu.

Przykłady

Uwaga: dostępne dla tej metody przykłady kodu nie odzwierciedlają wszystkich obsługiwanych języków programowania. Listę obsługiwanych języków znajdziesz na stronie z bibliotekami klienta.

Java

Używa biblioteki klienta 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

Używa biblioteki klienta Pythona.

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

Wypróbuj

Użyj eksploratora interfejsów API poniżej, aby wywołać tę metodę na aktywnych danych i zobaczyć odpowiedź. Możesz też wypróbować samodzielny eksplorator.