Variables: create

Yetkilendirme gerektiriyor

Bir GTM değişkeni 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/variables

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 Değişkenler kaynağı sağlayın:

Mülk adı	Değer	Açıklama	Notlar
Zorunlu Özellikler
name	string	Değişken 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
type	string	GTM Değişken Türü.	yazılabilir
İsteğe Bağlı Özellikler
disablingTriggerId[]	list	Yalnızca mobil kapsayıcılar için: Koşullu değişkenleri devre dışı bırakmaya yönelik tetikleyici kimliklerinin listesi; Etkinleştiren tetikleyicilerden biri doğru, tüm devre dışı bırakma tetikleyicileri yanlış ise değişken etkinleştirilir. Sıralanmamış bir grup olarak işlenir.	yazılabilir
enablingTriggerId[]	list	Yalnızca mobil kapsayıcılar için: Koşullu değişkenleri etkinleştirmeye yönelik tetikleyici kimliklerinin listesi; Etkinleştiren tetikleyicilerden biri doğru, tüm devre dışı bırakan tetikleyiciler yanlış ise değişken etkinleştirilir. Sıralanmamış bir grup olarak işlenir.	yazılabilir
notes	string	Kullanıcı, bu değişkenin kapsayıcıya nasıl uygulanacağıyla ilgili notları.	yazılabilir
parameter[]	list	Değişkenin 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
scheduleEndMs	long	Bir değişkenin programlanması için milisaniye cinsinden bitiş zaman damgası.	yazılabilir
scheduleStartMs	long	Bir değişkenin programlanması için milisaniye cinsinden başlangıç zaman damgası.	yazılabilir

Yanıt

Başarılı olursa bu yöntem yanıt gövdesinde bir Değişkenler 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 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

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

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

Deneyin!

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