Containers: update

Yetkilendirme gerektirir

Bir kapsayıcıyı 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

Parametreler

Parametre adı Değer Açıklama
Yol parametreleri
accountId string GTM Hesap Kimliği.
containerId string GTM Kapsayıcı Kimliği.
İsteğe bağlı sorgu parametreleri
fingerprint string Bu parmak izi sağlandığında, depolama alanındaki container'ın 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 Container kaynağı sağlayın:

Mülk adı Değer Açıklama Notlar
Zorunlu mülkler
usageContext[] list Kapsayıcı için Kullanım Bağlamlarının Listesi. Geçerli değerler şunları içerir: web, android, ios. yazılabilir
İsteğe Bağlı Özellikler
domainName[] list Kapsayıcı ile ilişkili alan adlarının isteğe bağlı listesi. yazılabilir
enabledBuiltInVariable[] list Etkin yerleşik değişkenlerin listesi. Geçerli değerler şunları içerir: pageUrl, pageHostname, pagePath, referrer, event, clickElement, clickClasses, clickId, clickTarget, clickUrl, clickText, formElement, formClasses, formId, formTarget, formUrl, formText, errorMessage, errorUrl, errorLine, newHistoryFragment, oldHistoryFragment, newHistoryState, oldHistoryState, historySource, containerVersion, debugMode, randomNumber, containerId. yazılabilir
name string Kapsayıcının görünen adı. yazılabilir
notes string Kapsayıcı Notları. yazılabilir
timeZoneCountryId string Kapsayıcı Ülke Kimliği. yazılabilir
timeZoneId string Kapsayıcı Saat Dilimi Kimliği. yazılabilir

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir Kapsayıcı 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 container for the authorized user.
 */

// Construct the container object.
Container container = new Container();
container.setName("Example Container");
container.setNotes("Example Container Notes.");
container.setTimeZoneCountryId("US");
container.setTimeZoneId("America/Los_Angeles");
container.setUsageContext(Arrays.asList("web", "android", "ios"));

try {
  Container response = tagmanager.accounts().
      containers().update("123456", "54321", container).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 container.
try:
  response = tagmanager.accounts().containers().update(
      accountId='123456',
      containerId='54321',
      body={
          'name': 'Example Container',
          'timeZoneCountryId': 'US',
          'timeZoneId': 'America/Los_Angeles',
          'usageContext': ['web', 'android']
      }
  ).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.