Containers: update

נדרשת הרשאה

מעדכן מאגר. אפשר לנסות עכשיו או לראות דוגמה.

בקשה

בקשת HTTP

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

פרמטרים

שם הפרמטר	Value	התיאור
פרמטרים של נתיב
accountId	string	מספר החשבון ב-GTM.
containerId	string	מזהה מאגר התגים של GTM.
פרמטרים אופציונליים של שאילתה
fingerprint	string	כשמזינים את טביעת האצבע, היא צריכה להתאים לטביעת האצבע של הקונטיינר באחסון.

הרשאות

בקשה זו מחייבת הרשאה בהיקף הבא (למידע נוסף על אימות והרשאה).

היקף
https://www.googleapis.com/auth/tagmanager.edit.containers

גוף הבקשה

בגוף הבקשה, מספקים משאב Containers עם המאפיינים הבאים:

שם הנכס	Value	התיאור	הערות
מאפיינים נדרשים
usageContext[]	list	רשימת הקשרי שימוש בקונטיינר. הערכים החוקיים כוללים: web, android, ios.	ניתן לכתיבה
מאפיינים אופציונליים
domainName[]	list	רשימה אופציונלית של שמות דומיינים המשויכים למאגר התגים.	ניתן לכתיבה
enabledBuiltInVariable[]	list	רשימה של משתנים מובנים מופעלים. הערכים החוקיים כוללים: 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.	ניתן לכתיבה
name	string	שם התצוגה של הקונטיינר.	ניתן לכתיבה
notes	string	הערות מאגר.	ניתן לכתיבה
timeZoneCountryId	string	מזהה המדינה של הקונטיינר.	ניתן לכתיבה
timeZoneId	string	מזהה אזור הזמן של הקונטיינר.	ניתן לכתיבה

תשובה

אם הפעולה בוצעה ללא שגיאות, השיטה הזו תחזיר משאב של מאגרי תגים בגוף התגובה.

דוגמאות

הערה: דוגמאות הקוד הזמינות לשיטה זו לא מייצגות את כל שפות התכנות הנתמכות (רשימת השפות הנתמכות זמינה בדף של ספריות המשתמשים).

Java

משתמש בספריית הלקוח של Java.

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

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

רוצה לנסות?

ניתן להשתמש ב-APIs Explorer שבהמשך כדי לקרוא לשיטה הזו בנתונים בזמן אמת ולראות את התגובה.