Method: presentations.batchUpdate

تطبيق تعديل واحد أو أكثر على العرض التقديمي

يتم التحقّق من صحة كل request قبل تطبيقه. إذا كان أي طلب غير صالح، سيفشل الطلب بأكمله ولن يتم تطبيق أي شيء.

تتضمّن بعض الطلبات replies لتزويدك ببعض المعلومات حول كيفية تطبيقها. لا تحتاج الطلبات الأخرى إلى عرض معلومات، بل يعرض كل منها ردًا فارغًا. يتطابق ترتيب الردود مع ترتيب الطلبات.

على سبيل المثال، لنفترض أنّك طلبت تنفيذ batchUpdate مع أربعة تعديلات، وأنّ التعديل الثالث فقط يعرض معلومات. سيتضمّن الردّ ردّين فارغَين: الردّ على الطلب الثالث، وردّ فارغ آخر، بهذا الترتيب.

بما أنّ مستخدمين آخرين قد يعدّلون العرض التقديمي، قد لا يعكس العرض التقديمي التغييرات التي أجريتها تمامًا، فقد يتم تعديل تغييراتك وفقًا للتغييرات التي يجريها المتعاونون. إذا لم يكن هناك متعاونون، يجب أن يعكس العرض التقديمي التغييرات التي أجريتها. في أيّ حال، نضمن تطبيق التعديلات في طلبك معًا بشكل ذري.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى 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

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

WriteControl

توفّر هذه السمة إمكانية التحكّم في طريقة تنفيذ طلبات الكتابة.

تمثيل JSON 
{
  "requiredRevisionId": string
}
الحقول
requiredRevisionId

string

revision ID العرض التقديمي المطلوب لطلب الكتابة في حال تحديد رقم تعريف المراجعة المطلوب ولم يكن مطابقًا لرقم تعريف المراجعة الحالي للعرض التقديمي، لن تتم معالجة الطلب وسيتم عرض الخطأ 400 Bad Request.

عندما يتم عرض رقم تعريف نسخة معدَّلة مطلوبة في ردّ، يشير ذلك إلى رقم تعريف النسخة المعدَّلة من المستند بعد تطبيق الطلب.

CommentUpdateState

حالة تعديلات التعليقات في طلب الدفعة

عمليات التعداد
COMMENT_UPDATE_STATE_UNSPECIFIED لم يتم تحديد حالة تعديلات التعليقات.
NO_UPDATES_REQUESTED لم يتم طلب أي تعديلات على التعليقات في طلب الدفعة.
ALL_SAVED تم تطبيق جميع التعديلات المطلوبة على التعليقات في طلب الدُفعة.
ALL_FAILED_UNKNOWN_REASON تعذّر إجراء جميع التعديلات المطلوبة على التعليقات.