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

Tags: update

Bir GTM etiketini günceller. Hemen deneyin veya bir örneğe göz atın.

İstek

HTTP isteği

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

Parametreler

Parametre adı	Değer	Açıklama
Yol parametreleri
`accountId`	`string`	GTM Hesap Kimliği.
`containerId`	`string`	GTM Kapsayıcı Kimliği.
`tagId`	`string`	GTM Etiket Kimliği.
İsteğe bağlı sorgu parametreleri
`fingerprint`	`string`	Bu parmak izi sağlandığında, depolama alanındaki etiketin parmak iziyle eşleşmelidir.

Yetkilendirme

Bu istek, aşağıdaki kapsamla yetkilendirme gerektirir (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 Etiketler kaynağı sağlayın:

Mülk adı	Değer	Açıklama	Notlar
Zorunlu mülkler
`name`	`string`	Etiketin görünen adı.	yazılabilir
`parameter[].type`	`string`	Parametre türü. Geçerli değerler şunlardır: `boolean`: Değer, "true" veya "false" olarak temsil edilen bir boole'yi temsil eder `integer`: Değer, 10 tabanında 64 bit imzalı bir tam sayı değerini temsil eder `list`: Parametre listesi belirtilmelidir `map`: Bir parametre eşlemesi belirtilmelidir `template`: Değer herhangi bir metni temsil eder; değişken referanslar (dize olmayan türler döndürebilen değişken referansları bile) içerebilir. `trigger_reference`: Değer, bir tetikleyiciyi temsil eder ve tetikleyici kimliği olarak temsil edilir Kabul edilebilir değerler şunlardır: "`boolean`" "`integer`" "`list`" "`map`" "`template`" "`triggerReference`"	yazılabilir
`priority.type`	`string`	Parametre türü. Geçerli değerler şunlardır: `boolean`: Değer, "true" veya "false" olarak temsil edilen bir boole'yi temsil eder `integer`: Değer, 10 tabanında 64 bit imzalı bir tam sayı değerini temsil eder `list`: Parametre listesi belirtilmelidir `map`: Bir parametre eşlemesi belirtilmelidir `template`: Değer herhangi bir metni temsil eder; değişken referanslar (dize olmayan türler döndürebilen değişken referansları bile) içerebilir. `trigger_reference`: Değer, bir tetikleyiciyi temsil eder ve tetikleyici kimliği olarak temsil edilir Kabul edilebilir değerler şunlardır: "`boolean`" "`integer`" "`list`" "`map`" "`template`" "`triggerReference`"	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 biri doğru olarak değerlendirilirse etiket etkinleşmez.	yazılabilir
`firingRuleId[]`	`list`	Tetikleme kuralı kimlikleri. Listelenen kurallardan herhangi biri doğru ve tüm `blockingRuleIds` (belirtilmişse) yanlış olduğunda etiket etkinleşir.	yazılabilir
`firingTriggerId[]`	`list`	Tetikleyen tetikleyici kimlikleri. Listelenen tetikleyicilerden herhangi biri doğru ve `blockingTriggerIds` değerinin tamamı (belirtildiyse) yanlış olduğunda etiket tetiklenir.	yazılabilir
`liveOnly`	`boolean`	Doğru değerine ayarlanırsa bu etiket yalnızca canlı ortamda tetiklenir (ör. önizleme veya hata ayıklama modunda tetiklenmez).	yazılabilir
`notes`	`string`	Bu etiketin kapsayıcıya nasıl uygulanacağıyla ilgili kullanıcı notları.	yazılabilir
`parameter[]`	`list`	Etiketin parametreleri.	yazılabilir
`parameter[].key`	`string`	Bir parametreyi benzersiz şekilde tanımlayan adlandırılmış anahtar. Harita değerleri ve üst düzey parametreler 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 (anahtar içermelidir, anahtarlar benzersiz olmalıdır).	yazılabilir
`parameter[].value`	`string`	Bir parametrenin değeri (" gibi değişken başvuruları içerebilir"), belirtilen türe uygun şekilde.	yazılabilir
`paused`	`boolean`	Etiket duraklatılmışsa doğru değerini alır.	yazılabilir
`priority`	`nested object`	Etiketin kullanıcı tanımlı sayısal önceliği. Etiketler, öncelik sırasına göre eşzamansız olarak tetiklenir. Daha yüksek sayısal değere sahip 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. Harita değerleri ve üst düzey parametreler 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 (anahtar içermelidir, anahtarlar benzersiz olmalıdır).	yazılabilir
`priority.value`	`string`	Bir parametrenin değeri (" gibi değişken başvuruları içerebilir"), belirtilen türe uygun şekilde.	yazılabilir
`scheduleEndMs`	`long`	Bir etiketin planlanacağı bitiş zaman damgası (milisaniye cinsinden).	yazılabilir
`scheduleStartMs`	`long`	Bir etiketin planlanacağı başlangıç zaman damgası (milisaniye cinsinden).	yazılabilir
`type`	`string`	GTM Etiket Türü.	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ı kullanmalıdır.

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

/*
 * This request updates an existing tag for the authorized user.
 */

// 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.setType("ua");
tag.setLiveOnly(false);
tag.setParameter(Arrays.asList(arg0, arg1));

try {
  Tag response = tagmanager.accounts().
      containers().tags().update("123456", "54321", "1", tag).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

/*
 * The results of the update method are stored in the response object.
 * The following code shows how to access the updated name and fingerprint.
 */
System.out.println("Updated Name = " + response.getName());
System.out.println("Updated Fingerprint = " + response.getFingerprint());

Python

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

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

# This request updates an existing new container tag.
try:
  response = tagmanager.accounts().containers().tags().update(
      accountId='123456',
      containerId='54321',
      tagId='1',
      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 update method are stored in the response object.
# The following code shows how to access the updated name and fingerprint.
print 'Updated Name = %s' % response.get('name')
print 'Updated Fingerprint = %s' % response.get('fingerprint')

Deneyin.

Aşağıdaki API Gezgini'ni kullanarak canlı verilerde bu yöntemi çağırın ve yanıtı görün.