Bu sayfa, Cloud Translation API ile çevrilmiştir.

Tags: create

GTM etiketi oluşturur. Şimdi deneyin veya bir örneğe göz atın.

İstek

HTTP isteği

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

Parametreler

Parametre adı	Değer	Açıklama
Yol parametreleri
`accountId`	`string`	GTM Hesap Kimliği.
`containerId`	`string`	GTM Kapsayıcı Kimliği.

Yetkilendirme

Bu istek, aşağıdaki kapsamla yetkilendirme gerektiriyor (kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinin).

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

İstek içeriği

İstek gövdesinde, aşağıdaki özelliklere sahip bir Etiket kaynağı sağlayın:

Mülk adı	Değer	Açıklama	Notlar
Zorunlu Özellikler
`name`	`string`	Etiketin görünen adı.	yazılabilir
`parameter[].type`	`string`	Parametre türü. Geçerli değerler aşağıda belirtilmiştir: `boolean`: Değer, "true" olarak gösterilen bir boole'yi temsil eder veya "false" `integer`: Değer, 10 tabanında 64 bit imzalı tam sayı değerini temsil eder `list`: Bir parametre listesi belirtilmelidir `map`: Bir parametre eşlemesi belirtilmelidir `template`: Değer herhangi bir metni temsil eder; bu değişken referanslar (dize olmayan türleri döndürebilecek değişken referanslar bile) içerebilir `trigger_reference`: Değer, tetikleyici kimliği olarak gösterilen bir tetikleyiciyi temsil eder. ziyaret edin. Kabul edilebilir değerler şunlardır: "`boolean`" "`integer`" "`list`" "`map`" "`template`" "`triggerReference`"	yazılabilir
`priority.type`	`string`	Parametre türü. Geçerli değerler aşağıda belirtilmiştir: `boolean`: Değer, "true" olarak gösterilen bir boole'yi temsil eder veya "false" `integer`: Değer, 10 tabanında 64 bit imzalı tam sayı değerini temsil eder `list`: Bir parametre listesi belirtilmelidir `map`: Bir parametre eşlemesi belirtilmelidir `template`: Değer herhangi bir metni temsil eder; bu değişken referanslar (dize olmayan türleri döndürebilecek değişken referanslar bile) içerebilir `trigger_reference`: Değer, tetikleyici kimliği olarak gösterilen bir tetikleyiciyi temsil eder. ziyaret edin. Kabul edilebilir değerler şunlardır: "`boolean`" "`integer`" "`list`" "`map`" "`template`" "`triggerReference`"	yazılabilir
`type`	`string`	GTM Etiket Türü.	yazılabilir
İsteğe Bağlı Özellikler
`blockingRuleId[]`	`list`	Engelleme kuralı kimlikleri. Listelenen kurallardan herhangi biri doğru olarak değerlendirilirse etiket etkinleşmez.	yazılabilir
`blockingTriggerId[]`	`list`	Tetikleyici kimlikleri engelleniyor. Listelenen tetikleyicilerden herhangi biri doğru olarak değerlendirilirse etiket etkinleşmez.	yazılabilir
`firingRuleId[]`	`list`	Tetikleme kuralı kimlikleri. Bir etiket, listelenen kurallardan herhangi biri doğru ve tüm `blockingRuleIds` (belirtilmişse) yanlış olduğunda tetiklenir.	yazılabilir
`firingTriggerId[]`	`list`	Etkinleştirme tetikleyicisi kimlikleri. Bir etiket, listelenen tetikleyicilerden herhangi biri doğru ve tüm `blockingTriggerIds` tetikleyicileri (belirtilmişse) yanlış olduğunda tetiklenir.	yazılabilir
`liveOnly`	`boolean`	Politika, Doğru değerine ayarlanırsa bu etiket yalnızca canlı ortamda tetiklenir (ör. önizleme veya hata ayıklama modunda etkinleşmez).	yazılabilir
`notes`	`string`	Kullanıcı, bu etiketin kapsayıcıya nasıl uygulanacağına ilişkin notları alır.	yazılabilir
`parameter[]`	`list`	Etiketin parametreleri.	yazılabilir
`parameter[].key`	`string`	Bir parametreyi benzersiz şekilde tanımlayan adlandırılmış anahtar. Üst düzey parametreler ve eşleme değerleri için gereklidir. Liste değerleri için yoksayılır.	yazılabilir
`parameter[].list[]`	`list`	Bu liste parametresinin parametreleri (anahtarlar yoksayılır).	yazılabilir
`parameter[].map[]`	`list`	Bu eşleme parametresinin parametreleri (anahtarlar içermelidir; anahtarlar benzersiz olmalıdır).	yazılabilir
`parameter[].value`	`string`	Belirtilen türe uygun bir parametrenin değeri ("" gibi değişken başvuruları içerebilir).	yazılabilir
`paused`	`boolean`	Etiket duraklatılmışsa doğru değerini döndürür.	yazılabilir
`priority`	`nested object`	Etiketin kullanıcı tarafından tanımlanan sayısal önceliği. Etiketler, öncelik sırasına göre eşzamansız olarak tetiklenir. Sayısal değeri daha yüksek olan etiketler önce tetiklenir. Bir etiketin önceliği, pozitif veya negatif bir değer olabilir. Varsayılan değer 0'dır.	yazılabilir
`priority.key`	`string`	Bir parametreyi benzersiz şekilde tanımlayan adlandırılmış anahtar. Üst düzey parametreler ve eşleme değerleri için gereklidir. Liste değerleri için yoksayılır.	yazılabilir
`priority.list[]`	`list`	Bu liste parametresinin parametreleri (anahtarlar yoksayılır).	yazılabilir
`priority.map[]`	`list`	Bu eşleme parametresinin parametreleri (anahtarlar içermelidir; anahtarlar benzersiz olmalıdır).	yazılabilir
`priority.value`	`string`	Belirtilen türe uygun bir parametrenin değeri ("" gibi değişken başvuruları içerebilir).	yazılabilir
`scheduleEndMs`	`long`	Etiketin programlanması için milisaniye cinsinden bitiş zaman damgası.	yazılabilir
`scheduleStartMs`	`long`	Bir etiketi programlamak için milisaniye cinsinden başlangıç zaman damgası.	yazılabilir

Yanıt

Başarılı olursa bu yöntem yanıt gövdesinde bir Etiketler kaynağı döndürür.

Örnekler

Not: Bu yöntem için kullanıma sunulan kod örnekleri, desteklenen tüm programlama dillerini kapsamaz (Desteklenen dillerin listesi için istemci kitaplıkları sayfasını inceleyin).

Java

Java istemci kitaplığını kullanır.

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

Python istemci kitaplığını kullanır.

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

Deneyin!

Canlı verilerde bu yöntemi çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.