- طلب HTTP
- معلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- طلب
- CreateslideRequest
- LayoutReference
- التنسيق المسبق التحديد
- LayoutPlaceholderIdMapping
- CreateRequestRequest
- PageElementProperties
- CreateTableRequest
- InsertTextRequest
- InsertTablerowsRequest
- InsertTableColumnRequest
- DeleteTableالصفوفRequest
- DeleteTableColumnRequest
- replaceAllTextRequest
- SubstringmatchSpecification
- DeleteObjectRequest
- UpdatePageElementTransformRequest
- ApplyMode
- UpdateالعروضPositionRequest
- DeleteTextRequest
- النطاق
- النوع
- CreateImageRequest
- CreateVideoRequest
- CreateSheetsChartRequest
- وضع الربط
- CreateLineRequest
- Category (الفئة)
- إعادة تحميل جداول البيانات في الرسم البياني
- UpdateFormatPropertiesRequest
- UpdateImagePropertiesRequest
- UpdateVideoPropertiesRequest
- UpdatePagePropertiesRequest
- UpdateTableCellularPropertiesRequest
- TableRange
- UpdateLinePropertiesRequest
- CreateParagraphBulletsRequest
- BulletGlyphPreset
- replaceAllFormatsWithImageRequest
- replaceMethod
- ImagereplaceMethod
- ObjectObjectRequest
- UpdateTextStyleRequest
- replaceAllFormatsWithSheetsChartRequest
- وضع الربط
- DeleteParagraphBulletsRequest
- UpdateParagraphStyleRequest
- UpdateTableBorderPropertiesRequest
- موضع الحدود
- UpdateTableColumnPropertiesRequest
- UpdateTableصفصف الموقع الإلكتروني
- MergeTableCellularsRequest
- إلغاء دمج خلايا الجدول
- GroupObjectsRequest
- UngroupObjectsRequest
- UpdatePageElementAltTextRequest
- replaceImageRequest
- UpdateslidePropertiesRequest
- UpdatePageElementsZOrderRequest
- ZOrderOperation
- UpdateLineCategoryRequest
- RerouteLineRequest
- كتابة عنصر التحكّم
- الردّ
- CreateResponseResponse
- CreateCreateResponse
- CreateTableResponse
- replaceAllTextResponse
- CreateImageResponse
- CreateVideoResponse
- CreateSheetsChartResponse
- CreateLineResponse
- replaceAllFormatsWithImageResponse
- إنشاء عنصر مكرّر
- replaceAllFormatsWithSheetsChartResponse
- GroupObjectsResponse
- جرِّبه الآن
يتم تطبيق تحديث واحد أو أكثر على العرض التقديمي.
ويتم التحقّق من صحة كل request
قبل تطبيقها. وفي حال كان أي طلب غير صالح، سيتعذّر تنفيذ الطلب بالكامل ولن يتم تنفيذ أيّ طلب.
تتيح بعض الطلبات replies
تقديم معلومات محددة حول كيفية تطبيقها. لا تحتاج الطلبات الأخرى إلى عرض معلومات، لأنّ كل منها يعرض ردًا فارغًا. يطابق ترتيب الردود الطلب.
على سبيل المثال، لنفترض أنّك تُجري اتصالاً مجمّعًا بأربع تحديثات، وأنّ التعديل الثالث فقط هو الذي يعرض المعلومات. سيكون للرد ردّين فارغَين: الرد على الطلب الثالث، ورد آخر فارغ، بالترتيب التالي.
ونظرًا لأنّ المستخدمين الآخرين قد يعدّلون العرض التقديمي، قد لا يعكس العرض التقديمي تغييراتك تحديدًا: قد يتم تغيير تغييراتك في ما يتعلق بتغييرات المتعاونين. في حال عدم وجود متعاونين، يجب أن يعكس العرض التقديمي تغييراتك. وفي جميع الحالات، نضمن تطبيق التعديلات في طلبك معًا بتنسيق Atom.
طلب HTTP
POST https://slides.googleapis.com/v1/presentations/{presentationId}:batchUpdate
يستخدم عنوان URL بنية gRPC Transcode.
معلّمات المسار
المعلّمات | |
---|---|
presentationId |
العرض التقديمي الذي سيتم تطبيق التعديلات عليه |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "requests": [ { object ( |
الحقول | |
---|---|
requests[] |
تمثّل هذه السمة قائمة بالتعديلات المراد تطبيقها على العرض التقديمي. |
writeControl |
يوفر إمكانية التحكّم في كيفية تنفيذ طلبات الكتابة. |
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
رسالة استجابة من تحديث مجمَّع.
تمثيل JSON |
---|
{ "presentationId": string, "replies": [ { object ( |
الحقول | |
---|---|
presentationId |
العرض التقديمي الذي تم تطبيق التعديلات عليه |
replies[] |
الردّ على التعديلات يؤدي هذا إلى ربط نسبة العرض إلى الارتفاع 1:1 بالتعديلات، إلا أنّ الردود على بعض الطلبات قد تكون فارغة. |
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 |
عند عرض معرّف النسخة السابقة المطلوب في رد، يشير هذا إلى رقم تعريف النسخة السابقة من المستند بعد تطبيق الطلب. |