Method: presentations.batchUpdate

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

כל request מאומת לפני היישום. אם בקשה כלשהי אינה חוקית, הבקשה כולה תיכשל ולא יושם שום דבר.

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

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

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

בקשת 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)

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

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