Workspaces: updateProposal

یک پیشنهاد GTM Workspace را به روز می کند. الآن امتحانش کن .

درخواست

درخواست HTTP

PUT https://www.googleapis.com/tagmanager/v2/path

مولفه های

نام پارامتر ارزش شرح
پارامترهای مسیر
path string مسیر نسبی پیشنهاد فضای کاری GTM: مثال: accounts/{aid}/containers/{cid}/workspace/{wid}/workspace_proposal

درخواست بدن

در بدنه درخواست، داده ها را با ساختار زیر ارائه دهید:

{
  "status": string,
  "reviewers": [
    {
      "type": string,
      "gaiaId": long
    }
  ],
  "newComment": {
    "content": string
  },
  "fingerprint": string
}
نام ملک ارزش شرح یادداشت
status string در صورت وجود، وضعیت پیشنهاد فضای کاری به روز می شود.

مقادیر قابل قبول عبارتند از:
  • " approved "
  • " cancelled "
  • " completed "
  • " requested "
  • " reviewed "
  • " statusUnspecified "
reviewers[] list در صورت وجود، لیست بازبینان پیشنهاد فضای کاری به روز می شود.
reviewers[]. type string نوع کاربر بین کاربر و سیستم مدیریت برچسب گوگل تمایز قائل می شود.

مقادیر قابل قبول عبارتند از:
  • " gaiaId "
  • " system "
reviewers[]. gaiaId long شناسه Gaia مرتبط با یک کاربر، برای سیستم مدیریت برچسب Google وجود ندارد.
newComment nested object در صورت وجود، یک نظر جدید به سابقه پیشنهاد فضای کاری اضافه می شود.
newComment. content string مطالب نظر بازبین یا نویسنده.
fingerprint string در صورت ارائه، این اثر انگشت باید با اثر انگشت پیشنهاد موجود در فضای ذخیره سازی مطابقت داشته باشد.

واکنش

در صورت موفقیت آمیز بودن، این روش یک بدنه پاسخ با ساختار زیر را برمی گرداند:

{
  "path": string,
  "status": string,
  "authors": [
    {
      "type": string,
      "gaiaId": long
    }
  ],
  "reviewers": [
    {
      "type": string,
      "gaiaId": long
    }
  ],
  "history": [
    {
      "type": string,
      "comment": {
        "content": string
      },
      "statusChange": {
        "oldStatus": string,
        "newStatus": string
      },
      "createdBy": {
        "type": string,
        "gaiaId": long
      },
      "createdTimestamp": {
        "seconds": long,
        "nanos": integer
      }
    }
  ],
  "fingerprint": string
}
نام ملک ارزش شرح یادداشت
path string مسیر نسبی پیشنهاد فضای کاری GTM.
status string وضعیت پیشنهاد فضای کاری در حین بررسی.

مقادیر قابل قبول عبارتند از:
  • " approved "
  • " cancelled "
  • " completed "
  • " requested "
  • " reviewed "
  • " statusUnspecified "
authors[] list فهرست نویسندگان برای پیشنهاد فضای کاری.
authors[]. type string نوع کاربر بین کاربر و سیستم مدیریت برچسب گوگل تمایز قائل می شود.

مقادیر قابل قبول عبارتند از:
  • " gaiaId "
  • " system "
authors[]. gaiaId long شناسه Gaia مرتبط با یک کاربر، برای سیستم مدیریت برچسب Google وجود ندارد.
reviewers[] list لیست بازبینی کنندگان برای پیشنهاد فضای کاری.
reviewers[]. type string نوع کاربر بین کاربر و سیستم مدیریت برچسب گوگل تمایز قائل می شود.

مقادیر قابل قبول عبارتند از:
  • " gaiaId "
  • " system "
reviewers[]. gaiaId long شناسه Gaia مرتبط با یک کاربر، برای سیستم مدیریت برچسب Google وجود ندارد.
history[] list تاریخچه نظرات و تغییرات وضعیت را ثبت می کند.
history[]. type string نوع سابقه تمایز بین نظرات و تغییرات وضعیت.

مقادیر قابل قبول عبارتند از:
  • " comment "
  • " statusChange "
  • " unspecified "
history[]. comment nested object نظر کاربر یا بازبین.
history[].comment. content string مطالب نظر بازبین یا نویسنده.
history[]. statusChange nested object تغییر در وضعیت پیشنهاد
history[].statusChange. oldStatus string وضعیت پیشنهادی قدیمی قبل از تغییر وضعیت.

مقادیر قابل قبول عبارتند از:
  • " approved "
  • " cancelled "
  • " completed "
  • " requested "
  • " reviewed "
  • " statusUnspecified "
history[].statusChange. newStatus string وضعیت پیشنهاد جدید پس از آن تغییر وضعیت.

مقادیر قابل قبول عبارتند از:
  • " approved "
  • " cancelled "
  • " completed "
  • " requested "
  • " reviewed "
  • " statusUnspecified "
history[]. createdBy nested object حزبی که مسئول تغییر تاریخ است.
history[].createdBy. type string نوع کاربر بین کاربر و سیستم مدیریت برچسب گوگل تمایز قائل می شود.

مقادیر قابل قبول عبارتند از:
  • " gaiaId "
  • " system "
history[].createdBy. gaiaId long شناسه Gaia مرتبط با یک کاربر، برای سیستم مدیریت برچسب Google وجود ندارد.
history[]. createdTimestamp nested object وقتی این رویداد تاریخی به پیشنهاد فضای کاری اضافه شد.
history[].createdTimestamp. seconds long ثانیه های زمان UTC را از زمان یونیکس 1970-01-01T00:00:00Z نشان می دهد. باید از 0001-01-01T00:00:00Z تا 9999-12-31T23:59:59Z شامل باشد.
history[].createdTimestamp. nanos integer کسرهای غیر منفی از ثانیه در وضوح نانوثانیه. مقادیر ثانویه منفی با کسرها باید همچنان مقادیر نانو غیر منفی داشته باشند که در زمان به جلو حساب می‌شوند. باید از 0 تا 999999999 باشد.
fingerprint string اثر انگشت پیشنهاد فضای کاری GTM همانطور که در زمان ذخیره سازی محاسبه می شود. هر زمان که پیشنهاد اصلاح شود، این مقدار مجدداً محاسبه می شود.

آن را امتحان کنید!

از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.