Method: presentations.batchUpdate

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

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

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

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

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

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

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

پارامترها
presentationId

string

ارائه برای اعمال به روز رسانی ها.

درخواست بدن

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

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

object ( Request )

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

writeControl

object ( WriteControl )

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

بدن پاسخگو

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

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

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

string

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

replies[]

object ( Response )

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

writeControl

object ( WriteControl )

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

محدوده مجوز

به یکی از حوزه های 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

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

WriteControl

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

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

string

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

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