Method: presentations.batchUpdate

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

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

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

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

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

طلب 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 خطأ الطلب غير صالح.

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