Method: presentations.batchUpdate

یک یا چند به‌روزرسانی را به ارائه اعمال می‌کند.

هر request قبل از اعمال، اعتبارسنجی می‌شود. اگر هر درخواستی معتبر نباشد، کل درخواست با شکست مواجه می‌شود و هیچ چیزی اعمال نخواهد شد.

برخی از درخواست‌ها دارای replies هستند که اطلاعاتی در مورد نحوه‌ی اعمال آنها به شما می‌دهند. سایر درخواست‌ها نیازی به بازگرداندن اطلاعات ندارند؛ این درخواست‌ها هر کدام یک پاسخ خالی برمی‌گردانند. ترتیب پاسخ‌ها با ترتیب درخواست‌ها مطابقت دارد.

برای مثال، فرض کنید تابع batchUpdate را با چهار به‌روزرسانی فراخوانی می‌کنید و فقط سومی اطلاعات را برمی‌گرداند. پاسخ دو پاسخ خالی خواهد داشت: پاسخ به درخواست سوم و یک پاسخ خالی دیگر، به همین ترتیب.

از آنجا که ممکن است کاربران دیگری در حال ویرایش ارائه باشند، ممکن است ارائه دقیقاً تغییرات شما را منعکس نکند: تغییرات شما ممکن است با توجه به تغییرات همکاران تغییر کند. اگر هیچ همکاری وجود نداشته باشد، ارائه باید تغییرات شما را منعکس کند. در هر صورت، تضمین می‌شود که به‌روزرسانی‌های درخواست شما به صورت خودکار اعمال شوند.

درخواست HTTP

POST https://slides.googleapis.com/v1/presentations/{presentationId}:batchUpdate

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
presentationId

string

ارائه‌ای که قرار است به‌روزرسانی‌ها روی آن اعمال شوند.

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
فیلدها
requests[]

object ( Request )

فهرستی از به‌روزرسانی‌هایی که باید در ارائه اعمال شوند.

writeControl

object ( WriteControl )

کنترل نحوه اجرای درخواست‌های نوشتن را فراهم می‌کند.

بدنه پاسخ

پیام پاسخ از به‌روزرسانی دسته‌ای.

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

نمایش JSON 
{
  "presentationId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "writeControl": {
    object (WriteControl)
  },
  "commentUpdateState": enum (CommentUpdateState)
}
فیلدها
presentationId

string

ارائه‌ای که به‌روزرسانی‌ها روی آن اعمال شده است.

replies[]

object ( Response )

پاسخ به‌روزرسانی‌ها. این به صورت ۱:۱ با به‌روزرسانی‌ها نگاشت می‌شود، اگرچه پاسخ به برخی درخواست‌ها ممکن است خالی باشد.

writeControl

object ( WriteControl )

کنترل نوشتن به‌روزرسانی‌شده پس از اعمال درخواست.

commentUpdateState

enum ( CommentUpdateState )

اینکه آیا به‌روزرسانی‌های نظرات در درخواست دسته‌ای اعمال شده‌اند یا خیر.

دامنه‌های مجوز

به یکی از حوزه‌های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/presentations
  • https://www.googleapis.com/auth/spreadsheets
  • https://www.googleapis.com/auth/spreadsheets.readonly

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.

کنترل نوشتن

کنترل نحوه اجرای درخواست‌های نوشتن را فراهم می‌کند.

نمایش JSON 
{
  "requiredRevisionId": string
}
فیلدها
requiredRevisionId

string

revision ID ارائه مورد نیاز برای درخواست نوشتن. اگر مشخص شود و شناسه‌ی ویرایش مورد نیاز با شناسه‌ی ویرایش فعلی ارائه مطابقت نداشته باشد، درخواست پردازش نمی‌شود و خطای درخواست نادرست ۴۰۰ را برمی‌گرداند.

وقتی یک شناسه‌ی ویرایش مورد نیاز در پاسخ برگردانده می‌شود، نشان‌دهنده‌ی شناسه‌ی ویرایش سند پس از اعمال درخواست است.

وضعیت به‌روزرسانی دیدگاه

وضعیت به‌روزرسانی‌های نظرات در درخواست دسته‌ای.

انوم‌ها
COMMENT_UPDATE_STATE_UNSPECIFIED وضعیت به‌روزرسانی نظرات مشخص نیست.
NO_UPDATES_REQUESTED هیچ به‌روزرسانی نظری در درخواست دسته‌ای درخواست نشده بود.
ALL_SAVED تمام به‌روزرسانی‌های درخواستی نظرات در درخواست دسته‌ای اعمال شدند.
ALL_FAILED_UNKNOWN_REASON تمام به‌روزرسانی‌های درخواستی نظرات با شکست مواجه شد.