Tags: update

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

لتعديل علامة "إدارة العلامات من Google" جرِّبه الآن أو شاهد مثالاً.

الطلب

طلب HTTP

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

المَعلمات

اسم المعلَمة القيمة الوصف
مَعلمات المسار
accountId string رقم تعريف حساب "إدارة العلامات من Google".
containerId string رقم تعريف حاوية Google Tag Manager
tagId string رقم تعريف علامة "إدارة العلامات من Google".
مَعلمات طلب البحث الاختيارية
fingerprint string وعند توفيرها، يجب أن تتطابق بصمة الإصبع هذه مع بصمة العلامة الموجودة في التخزين.

التفويض

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

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

نص الطلب

في نص الطلب، يمكنك توفير مورد العلامات بالسمات التالية:

اسم الموقع القيمة الوصف Notes
الخصائص المطلوبة
name string الإشارة إلى الاسم المعروض قابل للكتابة
parameter[].type string نوع المَعلمة. القيم الصالحة هي:
  • boolean: تمثّل القيمة قيمة منطقية، يتم تمثيلها على أنّها "صحيح" أو "خطأ"
  • integer: تمثل القيمة قيمة عدد صحيح موقّعة 64 بت، في الأساس 10
  • list: يجب تحديد قائمة بالمعلَمات
  • map: يجب تحديد خريطة للمعلَمات.
  • template: تمثّل القيمة أي نص، ويمكن أن تشمل مراجع المتغيّرة (حتى مراجع المتغيّرات التي قد تعرض أنواعًا غير سلاسل نصية).
  • trigger_reference: تمثّل القيمة مشغِّلاً، ويتم تمثيله على أنّه رقم تعريف المشغِّل.


القيم المقبولة هي:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
 قابل للكتابة
priority.type string نوع المَعلمة. القيم الصالحة هي:
  • boolean: تمثّل القيمة قيمة منطقية، يتم تمثيلها على أنّها "صحيح" أو "خطأ"
  • integer: تمثل القيمة قيمة عدد صحيح موقّعة 64 بت، في الأساس 10
  • list: يجب تحديد قائمة بالمعلَمات
  • map: يجب تحديد خريطة للمعلَمات.
  • template: تمثّل القيمة أي نص، ويمكن أن تشمل مراجع المتغيّرة (حتى مراجع المتغيّرات التي قد تعرض أنواعًا غير سلاسل نصية).
  • trigger_reference: تمثّل القيمة مشغِّلاً، ويتم تمثيله على أنّه رقم تعريف المشغِّل.


القيم المقبولة هي:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
 قابل للكتابة
الخصائص الاختيارية
blockingRuleId[] list أرقام تعريف قواعد الحظر إذا تم تقييم أي من القواعد المدرجة باعتبارها صحيحة، فلن يتم تنشيط العلامة. قابل للكتابة
blockingTriggerId[] list حظر معرِّفات المشغِّل إذا تم تقييم أي من العوامل المشغِّلة المدرجة على أنها صحيحة، لن يتم تنشيط العلامة. قابل للكتابة
firingRuleId[] list أرقام تعريف قواعد التنشيط. يتم تنشيط العلامة عندما تكون أي من القواعد المدرَجة صحيحة وجميع blockingRuleIds (إن وجدت) الخاصة بها غير صحيحة. قابل للكتابة
firingTriggerId[] list معرّفات مشغِّل التنشيط سيتم تنشيط العلامة عندما يكون أي من العوامل المشغِّلة المدرجة صحيحًا وجميع قيم blockingTriggerIds (إن وُجدت) غير صحيحة. قابل للكتابة
liveOnly boolean وفي حال ضبطها على "صحيح"، لن يتم تنشيط هذه العلامة إلا في البيئة المباشرة (على سبيل المثال، لن تكون في وضع المعاينة أو تصحيح الأخطاء). قابل للكتابة
notes string ويوضّح المستخدم كيفية تطبيق هذه العلامة في الحاوية. قابل للكتابة
parameter[] list معلَمات العلامة. قابل للكتابة
parameter[].key string المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. قابل للكتابة
parameter[].list[] list معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). قابل للكتابة
parameter[].map[] list معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). قابل للكتابة
parameter[].value string قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. قابل للكتابة
paused boolean صحيح إذا كانت العلامة متوقفة مؤقتًا. قابل للكتابة
priority nested object الأولوية الرقمية من تحديد المستخدم للعلامة. يتم تنشيط العلامات بشكلٍ غير متزامن بترتيب الأولوية. يتم تنشيط العلامات ذات القيمة الرقمية الأعلى أولاً. ويمكن أن تكون أولوية العلامة قيمة موجبة أو سلبية. القيمة التلقائية هي 0. قابل للكتابة
priority.key string المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. قابل للكتابة
priority.list[] list معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). قابل للكتابة
priority.map[] list معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). قابل للكتابة
priority.value string قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. قابل للكتابة
scheduleEndMs long الطابع الزمني للانتهاء بالمللي ثانية لجدولة علامة. قابل للكتابة
scheduleStartMs long الطابع الزمني للبدء بالمللي ثانية لجدولة علامة. قابل للكتابة
type string نوع علامة إدارة العلامات من Google قابل للكتابة

الإجابة

وفي حال نجاحها، تعرِض هذه الطريقة مورد العلامات في نص الاستجابة.

أمثلة

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

Java

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

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

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

تجربة

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