Ta strona została przetłumaczona przez Cloud Translation API.

Variables: create

Tworzy zmienną Menedżera tagów Google. Wypróbuj lub zobacz przykład.

Prośba

Żądanie HTTP

POST https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/variables

Parametry

Nazwa parametru	Wartość	Opis
Parametry ścieżki
`accountId`	`string`	Identyfikator konta Menedżera tagów Google.
`containerId`	`string`	Identyfikator kontenera Menedżera tagów Google.

Upoważnienie

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

Zakres
`https://www.googleapis.com/auth/tagmanager.edit.containers`

Treść żądania

W treści żądania podaj zasób zmiennych z tymi właściwościami:

nazwa usługi,	Wartość	Opis	Uwagi
Właściwości wymagane
`name`	`string`	Wyświetlana nazwa zmiennej.	z możliwością zapisu
`parameter[].type`	`string`	Typ parametru. Prawidłowe wartości to: `boolean`: wartość jest wartością logiczną „true” (prawda) lub „false” (fałsz). `integer`: wartość przedstawia 64-bitową liczbę całkowitą ze znakiem w systemie 10 `list`: należy określić listę parametrów `map`: należy określić mapę parametrów `template`: wartość reprezentuje dowolny tekst; może to być odwołania do zmiennych (nawet odwołania do zmiennych, które mogą zwracać typy inne niż ciągi znaków). `trigger_reference`: wartość reprezentuje regułę, reprezentującą ją identyfikator reguły. Akceptowane wartości: "`boolean`" "`integer`" "`list`" "`map`" "`template`" "`triggerReference`"	z możliwością zapisu
`type`	`string`	Typ zmiennej Menedżera tagów Google.	z możliwością zapisu
Właściwości opcjonalne
`disablingTriggerId[]`	`list`	Tylko kontenery mobilne: lista identyfikatorów reguł służących do wyłączania zmiennych warunkowych. Zmienna jest włączona, jeśli któraś z reguł uruchamiających jest prawda, a wszystkie reguły wyłączające mają wartość fałsz. Zbiór traktowany jako nieuporządkowany.	z możliwością zapisu
`enablingTriggerId[]`	`list`	Tylko kontenery mobilne: lista identyfikatorów reguł do włączania zmiennych warunkowych. Zmienna jest włączona, jeśli któraś z reguł uruchamiających jest prawda, a wszystkie reguły wyłączające mają wartość fałsz. Zbiór traktowany jako nieuporządkowany.	z możliwością zapisu
`notes`	`string`	Użytkownik informuje użytkownika, jak zastosować tę zmienną w kontenerze.	z możliwością zapisu
`parameter[]`	`list`	Parametry zmiennej.	z możliwością zapisu
`parameter[].key`	`string`	Nazwany klucz, który jednoznacznie identyfikuje parametr. Wymagane dla parametrów najwyższego poziomu oraz wartości mapy. Ignorowana w przypadku wartości list.	z możliwością zapisu
`parameter[].list[]`	`list`	Parametry tego parametru listy (klucze będą ignorowane).	z możliwością zapisu
`parameter[].map[]`	`list`	Parametry tego parametru mapy (muszą mieć klucze, a klucze muszą być unikalne).	z możliwością zapisu
`parameter[].value`	`string`	Wartość parametru (może zawierać odwołania do zmiennych takich jak „”) odpowiednio do określonego typu.	z możliwością zapisu
`scheduleEndMs`	`long`	Sygnatura czasowa zakończenia (w milisekundach) odpowiadająca zaplanowaniu zmiennej.	z możliwością zapisu
`scheduleStartMs`	`long`	Sygnatura czasowa rozpoczęcia (w milisekundach) planowania zmiennej.	z możliwością zapisu

Odpowiedź

Jeśli operacja się uda, metoda zwróci w treści odpowiedzi zasób zmiennych.

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

Korzysta z biblioteki klienta Java.

/*
 * Note: This code assumes you have an authorized tagmanager service object.
 */

/*
 * This request creates a new variable for the authorized user.
 */

// Create the variable object.
Variable variable = new Variable();
variable.setName("randomNumber");
variable.setType("r"); // The random number type.

try {
  Variable response = tagmanager.accounts().containers().
      variables().create("123456", "54321", variable).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

/*
 * The results of the create method are stored in the response object.
 * The following code shows how to access the created Id and Fingerprint.
 */
System.out.println("Variable Id = " + response.getVariableId());
System.out.println("Variable Fingerprint = " + response.getFingerprint());

Python

Używa biblioteki klienta dla języka Python.

# Note: This code assumes you have an authorized tagmanager service object.

# This request creates a new variable.
try:
  response = tagmanager.accounts().containers().variables().create(
      accountId='23732470',
      containerId='801231',
      body={
          'name': 'random_number',
          'type': 'r'
      }
  ).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))

# The results of the create method are stored in response object.
# The following code shows how to access the created id and fingerprint.
print 'Variable Id = %s' % response.get('variableId')
print 'Variable Fingerprint = %s' % response.get('fingerprint')

Wypróbuj

Użyj Eksploratora interfejsów API poniżej, aby wywołać tę metodę na aktywnych danych i zobaczyć odpowiedź.