- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- طلب
- CreateSlideRequest
- LayoutReference
- PredefinedLayout
- LayoutPlaceholderIdMapping
- CreateShapeRequest
- PageElementProperties
- CreateTableRequest
- InsertTextRequest
- InsertTableRowsRequest
- InsertTableColumnsRequest
- DeleteTableRowRequest
- DeleteTableColumnRequest
- ReplaceAllTextRequest
- SubstringMatchCriteria
- DeleteObjectRequest
- UpdatePageElementTransformRequest
- ApplyMode
- UpdateSlidesPositionRequest
- DeleteTextRequest
- النطاق
- النوع
- CreateImageRequest
- CreateVideoRequest
- CreateSheetsChartRequest
- LinkingMode
- CreateLineRequest
- Category (الفئة)
- RefreshSheetsChartRequest
- UpdateShapePropertiesRequest
- UpdateImagePropertiesRequest
- UpdateVideoPropertiesRequest
- UpdatePagePropertiesRequest
- UpdateTableCellPropertiesRequest
- TableRange
- UpdateLinePropertiesRequest
- CreateParagraphBulletsRequest
- BulletGlyphPreset
- ReplaceAllShapesWithImageRequest
- ReplaceMethod
- ImageReplaceMethod
- DuplicateObjectRequest
- UpdateTextStyleRequest
- ReplaceAllShapesWithSheetsChartRequest
- LinkingMode
- DeleteParagraphBulletsRequest
- UpdateParagraphStyleRequest
- UpdateTableBorderPropertiesRequest
- BorderPosition
- UpdateTableColumnPropertiesRequest
- UpdateTableRowPropertiesRequest
- MergeTableCellsRequest
- UnmergeTableCellsRequest
- GroupObjectsRequest
- UngroupObjectsRequest
- UpdatePageElementAltTextRequest
- ReplaceImageRequest
- UpdateSlidePropertiesRequest
- UpdatePageElementsZOrderRequest
- ZOrderOperation
- UpdateLineCategoryRequest
- RerouteLineRequest
- WriteControl
- الردّ
- CreateSlideResponse
- CreateShapeResponse
- CreateTableResponse
- ReplaceAllTextResponse
- CreateImageResponse
- CreateVideoResponse
- CreateSheetsChartResponse
- CreateLineResponse
- ReplaceAllShapesWithImageResponse
- DuplicateObjectResponse
- ReplaceAllShapesWithSheetsChartResponse
- GroupObjectsResponse
- جرِّبه الآن
تطبِّق تعديلاً واحدًا أو أكثر على العرض التقديمي.
يتم التحقّق من صحة كل request
قبل تطبيقها. وإذا كان أي طلب غير صالح، سيتعذّر تنفيذ الطلب بأكمله ولن يتم تطبيق أي إجراء.
تتضمّن بعض الطلبات "replies
" لتزويدك ببعض المعلومات عن كيفية تطبيقها. لا تتطلّب الطلبات الأخرى إرجاع المعلومات. فجميعها ينتج عنها ردًا فارغًا. يتطابق ترتيب الردود مع ترتيب الطلبات.
على سبيل المثال، لنفترض أنك استدعيت نسختَي التحديث بأربعة تحديثات، والثالث فقط هو الذي يعرض المعلومات. سيكون للاستجابة ردان فارغان: الرد على الطلب الثالث ورد فارغ آخر بهذا الترتيب.
نظرًا لاحتمال قيام مستخدمين آخرين بتعديل العرض التقديمي، فقد لا يعكس العرض التقديمي التغييرات التي أجريتها بالضبط: فقد يتم تغيير التغييرات التي أجريتها فيما يتعلق بتغييرات المتعاونين. في حال لم يكن هناك متعاونون، يجب أن يعكس العرض التقديمي التغييرات التي أجريتها. في أي حالة، يمكن ضمان تطبيق التعديلات في طلبك معًا على نحو ذري.
طلب HTTP
POST https://slides.googleapis.com/v1/presentations/{presentationId}:batchUpdate
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
presentationId |
العرض التقديمي المطلوب تطبيق التحديثات عليه |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "requests": [ { object ( |
الحقول | |
---|---|
requests[] |
قائمة بالتحديثات التي سيتم تطبيقها على العرض التقديمي. |
writeControl |
توفِّر هذه الميزة إمكانية التحكُّم في كيفية تنفيذ طلبات الكتابة. |
نص الاستجابة
رسالة ردّ من تعديل مجمّع
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "presentationId": string, "replies": [ { object ( |
الحقول | |
---|---|
presentationId |
العرض التقديمي الذي تم تطبيق التحديثات عليه. |
replies[] |
الرد على التعديلات. يؤدي هذا إلى الربط بين شخصين مع التعديلات، على الرغم من أن الردود على بعض الطلبات قد تكون فارغة. |
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 |
تمثّل هذه السمة عند إرجاع معرّف النسخة السابقة المطلوب في الرد، فإنه يشير إلى معرف النسخة السابقة للمستند بعد تطبيق الطلب. |