Yetkilendirme gerektirir
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:
Kabul edilebilir değerler şunlardır:
|
yazılabilir |
priority.type |
string |
Parametre türü. Geçerli değerler şunlardır:
Kabul edilebilir değerler şunlardı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 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.