Method: presentations.batchUpdate

החלת עדכון אחד או יותר על המצגת.

כל request מאומת לפני שהוא מיושם. אם אחת מהבקשות לא תקפה, הבקשה כולה תיכשל ולא תתבצע אף פעולה.

לצד חלק מהבקשות מופיע replies כדי לספק לכם מידע על האופן שבו הן חלות. בקשות אחרות לא צריכות להחזיר מידע, וכל אחת מהן מחזירה תשובה ריקה. סדר התשובות זהה לסדר הבקשות.

לדוגמה, נניח שקוראים ל-batchUpdate עם ארבעה עדכונים, ורק השלישי מחזיר מידע. התגובה תכלול שתי תשובות ריקות: התשובה לבקשה השלישית ותשובה ריקה נוספת, לפי הסדר הזה.

יכול להיות שמשתמשים אחרים עורכים את המצגת, ולכן יכול להיות שהיא לא תשקף בדיוק את השינויים שלכם: השינויים שלכם עשויים להשתנות בהתאם לשינויים של השותפים. אם אין שותפים, השינויים שלכם אמורים להופיע במצגת. בכל מקרה, מובטח שהעדכונים בבקשה יחולו יחד באופן אטומי.

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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)

התשובה לעדכונים. התשובות ממופות 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

מידע נוסף זמין במדריך ההרשאות.

WriteControl

מאפשרת לקבוע איך בקשות הכתיבה יבוצעו.

ייצוג ב-JSON 
{
  "requiredRevisionId": string
}
שדות
requiredRevisionId

string

ה-revision ID של המצגת שנדרש לבקשת הכתיבה. אם הפרמטר הזה צוין ומזהה הגרסה הנדרש לא תואם למזהה הגרסה הנוכחי של המצגת, הבקשה לא תעובד ותוחזר שגיאה מסוג 400 (בקשה לא חוקית).

כשמזהה גרסה נדרש מוחזר בתגובה, הוא מציין את מזהה הגרסה של המסמך אחרי שהבקשה הופעלה.