Method: presentations.batchUpdate

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

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

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

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

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المَعلمات
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

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

التحكّم في الكتابة

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

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

string

revision ID من العرض التقديمي المطلوب لطلب الكتابة. إذا تم تحديد معرّف النسخة السابقة المطلوب ولم يتطابق مع معرّف النسخة الحالية للعرض التقديمي، لن تتم معالجة الطلب وسيتم عرض رسالة خطأ 400 غير صحيحة.

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