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

Tags: create

Tworzy tag 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/tags

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 tagów z tymi właściwościami:

nazwa usługi,	Wartość	Opis	Uwagi
Właściwości wymagane
`name`	`string`	Wyświetlana nazwa tagu.	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
`priority.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 tagu Menedżera tagów Google.	z możliwością zapisu
Właściwości opcjonalne
`blockingRuleId[]`	`list`	Identyfikatory reguł blokowania. Jeśli któraś z wymienionych reguł ma wartość prawda, tag się nie uruchomi.	z możliwością zapisu
`blockingTriggerId[]`	`list`	Identyfikatory reguł blokujących. Jeśli któraś z tych reguł ma wartość Prawda, tag się nie uruchomi.	z możliwością zapisu
`firingRuleId[]`	`list`	Uruchamianie identyfikatorów reguł. Tag jest uruchamiany, gdy którakolwiek z wymienionych reguł jest prawdziwa, a wszystkie reguły `blockingRuleIds` (jeśli zostały określone) mają wartość fałsz.	z możliwością zapisu
`firingTriggerId[]`	`list`	Identyfikatory aktywatorów. Tag jest uruchamiany, gdy którakolwiek z tych reguł ma wartość prawda, a wszystkie jego reguły (`blockingTriggerIds`) mają wartość Fałsz.	z możliwością zapisu
`liveOnly`	`boolean`	Jeśli zasada ma wartość Prawda, ten tag będzie się uruchamiać tylko w środowisku aktywnym (np. nie w trybie podglądu ani debugowania).	z możliwością zapisu
`notes`	`string`	Użytkownik zauważa, jak zastosować ten tag w kontenerze.	z możliwością zapisu
`parameter[]`	`list`	Parametry tagu.	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
`paused`	`boolean`	Prawda, jeśli tag jest wstrzymany.	z możliwością zapisu
`priority`	`nested object`	Zdefiniowany przez użytkownika liczbowy priorytet tagu. Tagi są uruchamiane asynchronicznie w kolejności zgodnej z priorytetem. Tagi o większej wartości liczbowej uruchamiają się jako pierwsze. Priorytet tagu może być dodatni lub ujemny. Wartością domyślną jest 0.	z możliwością zapisu
`priority.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
`priority.list[]`	`list`	Parametry tego parametru listy (klucze będą ignorowane).	z możliwością zapisu
`priority.map[]`	`list`	Parametry tego parametru mapy (muszą mieć klucze, a klucze muszą być unikalne).	z możliwością zapisu
`priority.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) pozwalająca zaplanować tag.	z możliwością zapisu
`scheduleStartMs`	`long`	Sygnatura czasowa początku uruchomienia tagu (w milisekundach).	z możliwością zapisu

Odpowiedź

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

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

// Construct the parameters.
Parameter arg0 = new Parameter();
arg0.setType("template");
arg0.setKey("trackingId");
arg0.setValue("UA-123456-1");

Parameter arg1 = new Parameter();
arg1.setType("template");
arg1.setKey("type");
arg1.setValue("TRACK_TRANSACTION");

// Construct the tag object.
Tag tag = new Tag();
tag.setName("Sample Universal Analytics Tag");
tag.setType("ua");
tag.setLiveOnly(false);
tag.setParameter(Arrays.asList(arg0, arg1));

try {
  Tag response = tagmanager.accounts().containers().
      tags().create("123456", "54321", tag).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 response object.
 * The following code shows how to access the created id and fingerprint.
 */
System.out.println("Tag id = " + response.getTagId());
System.out.println("Tag 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 container tag.
try:
  response = tagmanager.accounts().containers().tags().create(
      accountId='123456',
      containerId='54321',
      body={
          'name': 'Universal Analytics Tag',
          'type': 'ua',
          'liveOnly': False,
          'parameter': [
              {
                  'type': 'template',
                  'key': 'trackingId',
                  'value': 'UA-123456-1'
              },
              {
                  'type': 'template',
                  'key': 'type',
                  'value': 'TRACK_TRANSACTION'
              }
          ]
      }
  ).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 the response object.
# The following code shows how to access the created id and fingerprint.
print response.get('tagId')
print response.get('fingerprint')

Wypróbuj

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