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)
  }
}
الحقول
presentationId

string

العرض التقديمي الذي تم تطبيق التعديلات عليه
replies[]

object (Response)

ردّ على التعديلات ويتم ربط هذه الطلبات بالتحديثات مباشرةً، على الرغم من أنّ الردود على بعض الطلبات قد تكون فارغة.
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 "الخطأ ناتج عن طلب غير صالح".

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