Containers: list

يجب تقديم تفويض

يسرد جميع الحاويات التي تنتمي إلى حساب GTM. جرِّبه الآن أو شاهد مثالاً.

الطلب

طلب HTTP

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

المَعلمات

اسم المعلَمة	القيمة	الوصف
مَعلمات المسار
accountId	string	رقم تعريف حساب "إدارة العلامات من Google".

التفويض

يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات حول المصادقة والتفويض).

النطاق
https://www.googleapis.com/auth/tagmanager.readonly
https://www.googleapis.com/auth/tagmanager.edit.containers

نص الطلب

لا توفِّر نص طلب بهذه الطريقة.

الإجابة

في حال نجاحها، تعرض هذه الطريقة نص استجابة بالبنية التالية:

{
  "containers": [
    accounts.containers Resource
  ]
}

اسم الموقع	القيمة	الوصف	Notes
containers[]	list	جميع حاويات حساب Google Tag Manager

أمثلة

ملاحظة: إنّ الأمثلة المرتبطة بالرموز والمتوفرة لهذه الطريقة لا تمثّل كل لغات البرمجة المتوافقة (يُرجى مراجعة صفحة مكتبات البرامج للاطّلاع على قائمة باللغات المتوافقة).

Java

تستخدم مكتبة عميل Java.

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

/*
 * This request lists all containers for the authorized user.
 */
try {
  ListContainersResponse containers =
      tagmanager.accounts().containers().list("123456").execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

/*
 * The results of the list method are stored in the containers object.
 * The following code shows how to iterate through them.
 */
for (Container container : containers.getContainers()) {
  System.out.println("Account Id = " + container.getAccountId());
  System.out.println("Container Id = " + container.getContainerId());
  System.out.println("Container Name = " + container.getName());
  if (container.getDomainName() != null) {
    for (String domain : container.getDomainName()) {
      System.out.println("Domain Name = " + domain);
    }
  }
  System.out.println("Timezone Country Id = "
      + container.getTimeZoneCountryId());
  System.out.println("Timezone Id = " + container.getTimeZoneId());
  System.out.println("Container Notes = " + container.getNotes());
  for (String usageContext : container.getUsageContext()) {
    System.out.println("Usage context = " + usageContext);
  }
  System.out.println("Container Fingerprint = " + container.getFingerprint());
}

Python

تستخدم مكتبة برامج Python.

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

# This request lists all containers for the authorized user.
try:
  containers = tagmanager.accounts().containers().list(
      accountId='123456'
  ).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 list method are stored in the containers object.
# The following code shows how to iterate through them.
for container in containers.get('containers', []):
  print 'Account Id = %s' % container.get('accountId')
  print 'Container Id = %s' % container.get('containerId')
  print 'Container Name = %s' % container.get('name')
  for domain in container.get('domainName', []):
    print 'Domain Name = %s' % domain
  print 'Timezone Country Id = %s' % container.get('timeZoneCountryId')
  print 'Timezone Id = %s' % container.get('timeZone')
  print 'Notes = %s' % container.get('notes')
  for usageContext in container.get('usageContext'):
    print 'Usage Context = %s' % usageContext
  print 'Container Fingerprint = %s\n\n' % container.get('fingerprint')

تجربة

يمكنك استخدام مستكشف واجهات برمجة التطبيقات أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.