Requests

בקשה

סוג אחד של עדכון שחל על מצגת.

ייצוג JSON 
{

  // Union field kind can be only one of the following:
  "createSlide": {
    object (CreateSlideRequest)
  },
  "createShape": {
    object (CreateShapeRequest)
  },
  "createTable": {
    object (CreateTableRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "insertTableRows": {
    object (InsertTableRowsRequest)
  },
  "insertTableColumns": {
    object (InsertTableColumnsRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "deleteObject": {
    object (DeleteObjectRequest)
  },
  "updatePageElementTransform": {
    object (UpdatePageElementTransformRequest)
  },
  "updateSlidesPosition": {
    object (UpdateSlidesPositionRequest)
  },
  "deleteText": {
    object (DeleteTextRequest)
  },
  "createImage": {
    object (CreateImageRequest)
  },
  "createVideo": {
    object (CreateVideoRequest)
  },
  "createSheetsChart": {
    object (CreateSheetsChartRequest)
  },
  "createLine": {
    object (CreateLineRequest)
  },
  "refreshSheetsChart": {
    object (RefreshSheetsChartRequest)
  },
  "updateShapeProperties": {
    object (UpdateShapePropertiesRequest)
  },
  "updateImageProperties": {
    object (UpdateImagePropertiesRequest)
  },
  "updateVideoProperties": {
    object (UpdateVideoPropertiesRequest)
  },
  "updatePageProperties": {
    object (UpdatePagePropertiesRequest)
  },
  "updateTableCellProperties": {
    object (UpdateTableCellPropertiesRequest)
  },
  "updateLineProperties": {
    object (UpdateLinePropertiesRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "replaceAllShapesWithImage": {
    object (ReplaceAllShapesWithImageRequest)
  },
  "duplicateObject": {
    object (DuplicateObjectRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "replaceAllShapesWithSheetsChart": {
    object (ReplaceAllShapesWithSheetsChartRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "updateTableBorderProperties": {
    object (UpdateTableBorderPropertiesRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableRowProperties": {
    object (UpdateTableRowPropertiesRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "groupObjects": {
    object (GroupObjectsRequest)
  },
  "ungroupObjects": {
    object (UngroupObjectsRequest)
  },
  "updatePageElementAltText": {
    object (UpdatePageElementAltTextRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateSlideProperties": {
    object (UpdateSlidePropertiesRequest)
  },
  "updatePageElementsZOrder": {
    object (UpdatePageElementsZOrderRequest)
  },
  "updateLineCategory": {
    object (UpdateLineCategoryRequest)
  },
  "rerouteLine": {
    object (RerouteLineRequest)
  }
  // End of list of possible types for union field kind.
}
שדות
שדה איחוד kind. סוג העדכון. חובה למלא שדה אחד בדיוק. kind יכול להיות רק אחד מהבאים:
createSlide

object (CreateSlideRequest)

יוצר שקף חדש.

createShape

object (CreateShapeRequest)

יוצר צורה חדשה.

createTable

object (CreateTableRequest)

יצירת טבלה חדשה.

insertText

object (InsertTextRequest)

הוספת טקסט לצורה או לתא בטבלה.

insertTableRows

object (InsertTableRowsRequest)

הוספת שורות לטבלה.

insertTableColumns

object (InsertTableColumnsRequest)

הוספת עמודות לטבלה.

deleteTableRow

object (DeleteTableRowRequest)

מחיקת שורה מהטבלה.

deleteTableColumn

object (DeleteTableColumnRequest)

מחיקת עמודה מהטבלה.

replaceAllText

object (ReplaceAllTextRequest)

החלפת כל המופעים של טקסט מסוים.

deleteObject

object (DeleteObjectRequest)

מחיקת דף או רכיב דף מהמצגת.

updatePageElementTransform

object (UpdatePageElementTransformRequest)

עדכון הטרנספורמציה של רכיב דף.

updateSlidesPosition

object (UpdateSlidesPositionRequest)

עדכון המיקום של קבוצת שקפים במצגת.

deleteText

object (DeleteTextRequest)

מחיקת טקסט מצורה או מתא בטבלה.

createImage

object (CreateImageRequest)

יצירת תמונה.

createVideo

object (CreateVideoRequest)

יצירת סרטון.

createSheetsChart

object (CreateSheetsChartRequest)

יצירת תרשים הטמעת של Google Sheets.

createLine

object (CreateLineRequest)

יוצר קו.

refreshSheetsChart

object (RefreshSheetsChartRequest)

מרענן תרשים של Google Sheets.

updateShapeProperties

object (UpdateShapePropertiesRequest)

עדכון המאפיינים של Shape.

updateImageProperties

object (UpdateImagePropertiesRequest)

מתבצע עדכון של המאפיינים של Image.

updateVideoProperties

object (UpdateVideoPropertiesRequest)

עדכון המאפיינים של Video.

updatePageProperties

object (UpdatePagePropertiesRequest)

עדכון המאפיינים של Page.

updateTableCellProperties

object (UpdateTableCellPropertiesRequest)

עדכון המאפיינים של TableCell.

updateLineProperties

object (UpdateLinePropertiesRequest)

עדכון המאפיינים של Line.

createParagraphBullets

object (CreateParagraphBulletsRequest)

יוצרת תבליטים לפסקאות.

replaceAllShapesWithImage

object (ReplaceAllShapesWithImageRequest)

החלפת כל הצורות שתואמות לקריטריונים מסוימים בתמונה.

duplicateObject

object (DuplicateObjectRequest)

משכפל שקף או רכיב דף.

updateTextStyle

object (UpdateTextStyleRequest)

עדכון סגנון הטקסט בתוך Shape או Table.

replaceAllShapesWithSheetsChart

object (ReplaceAllShapesWithSheetsChartRequest)

החלפת כל הצורות שתואמות לקריטריונים מסוימים בתרשים Google Sheets.

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

מחיקת תבליטים מפסקאות.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

עדכון הסגנון של פסקאות בתוך Shape או Table.

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

עדכון המאפיינים של גבולות הטבלה בTable.

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

עדכון המאפיינים בעמודה Table.

updateTableRowProperties

object (UpdateTableRowPropertiesRequest)

עדכון המאפיינים של שורה Table.

mergeTableCells

object (MergeTableCellsRequest)

מיזוג תאים בתוך Table.

unmergeTableCells

object (UnmergeTableCellsRequest)

ביטול המיזוג של תאים ב-Table.

groupObjects

object (GroupObjectsRequest)

אובייקטים מקובצים, כמו רכיבי דף.

ungroupObjects

object (UngroupObjectsRequest)

ביטול הקיבוץ של אובייקטים, כמו groups.

updatePageElementAltText

object (UpdatePageElementAltTextRequest)

עדכון השם או התיאור של הטקסט החלופי ב-page element.

replaceImage

object (ReplaceImageRequest)

מחליפה תמונה קיימת בתמונה חדשה.

updateSlideProperties

object (UpdateSlidePropertiesRequest)

עדכון המאפיינים של שקף

updatePageElementsZOrder

object (UpdatePageElementsZOrderRequest)

עדכון של סדר ה-Z של page elements.

updateLineCategory

object (UpdateLineCategoryRequest)

עדכון הקטגוריה של line.

rerouteLine

object (RerouteLineRequest)

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

CreateSlideRequest

יוצר שקף.

ייצוג JSON 
{
  "objectId": string,
  "insertionIndex": integer,
  "slideLayoutReference": {
    object (LayoutReference)
  },
  "placeholderIdMappings": [
    {
      object (LayoutPlaceholderIdMapping)
    }
  ]
}
שדות
objectId

string

מזהה אובייקט שסופק על ידי המשתמש.

אם מציינים מזהה, הוא צריך להיות ייחודי בין כל הדפים ורכיבי הדפים במצגת. המזהה חייב להתחיל בתו אלפאנומרי או בקו תחתון (תואם לביטוי רגולרי [a-zA-Z0-9_]); התווים הנותרים חייבים לכלול מקף או נקודתיים (תואם לביטוי רגולרי [a-zA-Z0-9_-:]). האורך של המזהה חייב להיות בין 5 ל-50 תווים, כולל.

אם לא תציינו מזהה, ייווצר מזהה ייחודי.

insertionIndex

integer

אינדקס אופציונלי מבוסס אפס שמציין היכן להוסיף את השקפים.

אם לא מציינים אינדקס, השקף נוצר בסוף.

slideLayoutReference

object (LayoutReference)

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

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

אם ה-LayoutReference לא נמצא במאסטר הנוכחי, מחזירה שגיאת 400 של בקשה שגויה.

אם לא מציינים קובץ עזר לפריסה, השקף ישתמש בפריסת BLANK שהוגדרה מראש.

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

רשימה אופציונלית של מיפויים של מזהי אובייקטים מ-placeholder של הפריסה, לערכי ה-placeholder שנוצרו בשקף מהפריסה שצוינה. ניתן להשתמש באפשרות הזו רק אם צוין slideLayoutReference.

מדריך לפריסה

הפניה לפריסת שקפים. אלה עשויים להתייחס ל:

  • פריסה מוגדרת מראש
  • אחת מהפריסות במצגת.
ייצוג JSON 
{

  // Union field kind can be only one of the following:
  "predefinedLayout": enum (PredefinedLayout),
  "layoutId": string
  // End of list of possible types for union field kind.
}
שדות
שדה איחוד kind. הסוג של LayoutReference. kind יכול להיות רק אחד מהבאים:
predefinedLayout

enum (PredefinedLayout)

פריסה מוגדרת מראש.

layoutId

string

מזהה פריסה: מזהה האובייקט של אחת מהפריסות במצגת.

פריסה מוגדרת מראש

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

טיפוסים בני מנייה (enum)
PREDEFINED_LAYOUT_UNSPECIFIED פריסה לא מוגדרת
BLANK פריסה ריקה, ללא placeholders.
CAPTION_ONLY פריסה עם כיתוב למטה.
TITLE פריסה עם כותרת וכותרת משנה.
TITLE_AND_BODY פריסה עם כותרת וטקסט.
TITLE_AND_TWO_COLUMNS פריסה עם כותרת ושתי עמודות.
TITLE_ONLY פריסה עם כותרת בלבד.
SECTION_HEADER פריסה עם כותרת הקטע.
SECTION_TITLE_AND_DESCRIPTION פריסה עם כותרת וכותרת משנה בצד אחד ותיאור בצד השני.
ONE_COLUMN_TEXT פריסה עם כותרת אחת וגוף אחד, מאורגנת בעמודה אחת.
MAIN_POINT פריסה עם נקודה ראשית.
BIG_NUMBER פריסה עם כותרת גדולה של מספר.

LayoutPlaceholderIdמיפוי

מיפוי המזהה שצוין על ידי משתמש עבור placeholder שייווצר בשקף מפריסה שצוינה.

ייצוג JSON 
{
  "objectId": string,

  // Union field kind can be only one of the following:
  "layoutPlaceholder": {
    object (Placeholder)
  },
  "layoutPlaceholderObjectId": string
  // End of list of possible types for union field kind.
}
שדות
objectId

string

מזהה אובייקט שסופק על ידי המשתמש עבור ה-placeholder שצוין למעלה, שאותו יש ליצור בשקף.

אם מציינים מזהה, הוא צריך להיות ייחודי בין כל הדפים ורכיבי הדפים במצגת. המזהה חייב להתחיל בתו אלפאנומרי או בקו תחתון (תואם לביטוי רגולרי [a-zA-Z0-9_]); התווים הנותרים חייבים לכלול מקף או נקודתיים (תואם לביטוי רגולרי [a-zA-Z0-9_-:]). האורך של המזהה לא יכול להיות קצר מ-5 או גדול מ-50.

אם לא תציינו מזהה, ייווצר מזהה ייחודי.

שדה איחוד kind. הסוג הזה כדי לזהות placeholder בפריסה. kind יכול להיות רק אחד מהבאים:
layoutPlaceholder

object (Placeholder)

ה-placeholder בפריסה שתוחל על שקף. רק type ו-index נדרשים. לדוגמה, לפריסה מוגדרת מראש של TITLE_AND_BODY יכול להיות בדרך כלל placeholder של כותרת, עם אינדקס 0 ו-placeholder ל-Body עם אינדקס 0.

layoutPlaceholderObjectId

string

מזהה האובייקט של ה-placeholder בפריסה שתוחל על שקף.

CreateצורRequest

יוצר צורה חדשה.

ייצוג JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "shapeType": enum (Type)
}
שדות
objectId

string

מזהה אובייקט שסופק על ידי המשתמש.

אם מציינים מזהה, הוא צריך להיות ייחודי בין כל הדפים ורכיבי הדפים במצגת. המזהה חייב להתחיל בתו אלפאנומרי או בקו תחתון (תואם לביטוי רגולרי [a-zA-Z0-9_]); התווים הנותרים חייבים לכלול מקף או נקודתיים (תואם לביטוי רגולרי [a-zA-Z0-9_-:]). האורך של המזהה לא יכול להיות קצר מ-5 או גדול מ-50. אם השדה ריק, המערכת תיצור מזהה ייחודי.

elementProperties

object (PageElementProperties)

מאפייני הרכיב של הצורה.

shapeType

enum (Type)

סוג הצורה.

מאפייני דף

מאפיינים נפוצים של רכיב דף.

הערה: כשיוצרים PageElement, ה-API עשוי לשנות את הערכים של size ושל transform, אבל הגודל החזותי לא ישתנה.

ייצוג JSON 
{
  "pageObjectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  }
}
שדות
pageObjectId

string

מזהה האובייקט של הדף שבו הרכיב נמצא.

size

object (Size)

גודל הרכיב.

transform

object (AffineTransform)

הטרנספורמציה של הרכיב.

CreateTableRequest

יצירת טבלה חדשה.

ייצוג JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "rows": integer,
  "columns": integer
}
שדות
objectId

string

מזהה אובייקט שסופק על ידי המשתמש.

אם מציינים מזהה, הוא צריך להיות ייחודי בין כל הדפים ורכיבי הדפים במצגת. המזהה חייב להתחיל בתו אלפאנומרי או בקו תחתון (תואם לביטוי רגולרי [a-zA-Z0-9_]); התווים הנותרים חייבים לכלול מקף או נקודתיים (תואם לביטוי רגולרי [a-zA-Z0-9_-:]). האורך של המזהה לא יכול להיות קצר מ-5 או גדול מ-50.

אם לא תציינו מזהה, ייווצר מזהה ייחודי.

elementProperties

object (PageElementProperties)

מאפייני הרכיב בטבלה.

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

טרנספורמציות טבלה חייבות להיות בקנה מידה של 1 וללא רכיבי חיתוך. אם לא תספק טרנספורמציה, הטבלה תתמקד במרכז הדף.

rows

integer

מספר השורות בטבלה.

columns

integer

מספר העמודות בטבלה.

InsertTextRequest

הוספת טקסט לצורה או לתא בטבלה.

ייצוג JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "text": string,
  "insertionIndex": integer
}
שדות
objectId

string

מזהה האובייקט של הצורה או הטבלה שבהן הטקסט יוכנס.

cellLocation

object (TableCellLocation)

המיקום האופציונלי של תא בטבלה אם רוצים להוסיף את הטקסט לתא. אם השדה קיים, ה-ObjectId חייב להתייחס לטבלה.

text

string

הטקסט להוספה.

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

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

כמה תווי בקרה (U+0000-U+0008, U+000C-U+001F) ותווים מאזור השימוש הפרטי במטוס הרב-תרבותי של Unicode (U+E000-U+F8FF) יוסרו מהטקסט שנוסף.

insertionIndex

integer

האינדקס שבו יתווסף הטקסט, ביחידות קוד Unicode, על סמך TextElement אינדקסים.

האינדקס מבוסס על אפס והוא מחושב מתחילת המחרוזת. ניתן להתאים את האינדקס כדי למנוע הוספות באשכולות Unicode של Unicode. במקרים כאלה, הטקסט יתווסף מיד אחרי אשכול התרשימים.

InsertTableRowsRequest

הוספת שורות לטבלה.

ייצוג JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean,
  "number": integer
}
שדות
tableObjectId

string

הטבלה שאליה יש להוסיף שורות.

cellLocation

object (TableCellLocation)

המיקום בתא שבו נמצאת טבלת ההפניות, שבה יתווספו השורות.

שורה חדשה תתווסף מעל (או מתחת) לשורה שבה נמצא תא ההפניה. אם התא ההפניה הוא תא שמוזג, תוכנס שורה חדשה מעל (או מתחת) לתא שמוזג.

insertBelow

boolean

האם להוסיף שורות חדשות מתחת למיקום של ההפניה?

  • True : הוספה מתחת לתא.
  • False : הוספה מעל לתא.
number

integer

מספר השורות להוספה. 20 בקשות לכל היותר.

InsertTableColumnRequest

הוספת עמודות לטבלה.

הגודל של עמודות אחרות בטבלה ישתנה כך שיתאים לעמודה החדשה.

ייצוג JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean,
  "number": integer
}
שדות
tableObjectId

string

הטבלה שאליה יועברו העמודות.

cellLocation

object (TableCellLocation)

המיקום בתא שבו נמצאת טבלת ההפניות, שממנו יתווספו העמודות.

עמודה חדשה תתווסף משמאל (או לימין) של העמודה שבה נמצא תא ההפניה. אם התא המפנה הוא תא שהוכנס, עמודה חדשה תתווסף משמאל (או מימין) של התא שמוזג.

insertRight

boolean

האם להוסיף עמודות חדשות מימין למיקום של תא ההפניה.

  • True : הוספה בצד ימין.
  • False : הוספה בצד שמאל.
number

integer

מספר העמודות להוספה. 20 בקשות לכל היותר.

DeleteTableRowRequest

מחיקת שורה מהטבלה.

ייצוג JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
שדות
tableObjectId

string

הטבלה שממנה יש למחוק שורות.

cellLocation

object (TableCellLocation)

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

השורה שבה התא הזה תימחק. אם זהו תא שמוזג, מספר שורות יימחקו. אם לא יימחקו שורות בטבלה אחרי המחיקה הזו, כל הטבלה תימחק.

DeleteTableColumnRequest

מחיקת עמודה מהטבלה.

ייצוג JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
שדות
tableObjectId

string

הטבלה שממנה יש למחוק את העמודות.

cellLocation

object (TableCellLocation)

המיקום של התא בטבלת ההפניה, שממנו תימחק עמודה.

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

החלפת AllTextRequest

החלפת כל המופעים של טקסט שתואם לקריטריונים ב- replace text.

ייצוג JSON 
{
  "replaceText": string,
  "pageObjectIds": [
    string
  ],

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.
}
שדות
replaceText

string

הטקסט שיחליף את הטקסט התואם.

pageObjectIds[]

string

אם לא ריק, מגביל את ההתאמות לרכיבי דף רק בדפים הנתונים.

מחזירה שגיאת 400 של בקשה שגויה אם קיים מזהה אובייקט דף של notes master, או אם דף עם מזהה האובייקט לא קיים במצגת.

שדה איחוד criteria. הקריטריונים שמשמשים להתאמה של טקסט להחלפה. criteria יכול להיות רק אחד מהבאים:
containsText

object (SubstringMatchCriteria)

חיפוש טקסט בצורה שתואמת למחרוזת המשנה הזו.

מחרוזות משנה של התאמה

קריטריון שתואם למחרוזת טקסט ספציפית בצורה או בטבלה.

ייצוג JSON 
{
  "text": string,
  "matchCase": boolean
}
שדות
text

string

הטקסט שיש לחפש בצורה או בטבלה.

matchCase

boolean

מציין אם החיפוש צריך להתייחס לאותיות רישיות:

  • True : החיפוש הוא תלוי אותיות רישיות.
  • False : החיפוש לא תלוי באותיות רישיות.

DeleteObjectRequest

מחיקת אובייקט מהמצגת pages או page elements מהמצגת.

ייצוג JSON 
{
  "objectId": string
}
שדות
objectId

string

מזהה האובייקט של הדף או רכיב הדף למחיקה.

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

אם ה-placeholder נמחק בפריסה, כל ה-placeholders הריקים הריקים יימחקו.

UpdatePageElementTransformRequest

עדכון הטרנספורמציה של רכיב דף.

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

ייצוג JSON 
{
  "objectId": string,
  "transform": {
    object (AffineTransform)
  },
  "applyMode": enum (ApplyMode)
}
שדות
objectId

string

מזהה האובייקט של רכיב הדף שיש לעדכן.

transform

object (AffineTransform)

מטריצת הטרנספורמציה של הקלט המשמשת לעדכון רכיב הדף.

applyMode

enum (ApplyMode)

מצב ההחלה של עדכון הטרנספורמציה.

החלת מצב

מצבי היישום של עדכון הטרנספורמציה.

טיפוסים בני מנייה (enum)
APPLY_MODE_UNSPECIFIED מצב לא מוגדר.
RELATIVE החלת מטריצה חדשה של AffineTransform למטריצה הקיימת. היא תחליף את המטריצה הקיימת בשרשור שמתקבל.
ABSOLUTE מחליפה את המטריצה הקיימת ב-AffineTransform במטריצה החדשה.

עדכון SlidesSlidesRequest

עדכון המיקום של שקפים במצגת.

ייצוג JSON 
{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}
שדות
slideObjectIds[]

string

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

insertionIndex

integer

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

DeleteTextRequest

מחיקת טקסט מצורה או מתא בטבלה.

ייצוג JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
שדות
objectId

string

מזהה האובייקט של הצורה או הטבלה שמהם הטקסט יימחק.

cellLocation

object (TableCellLocation)

המיקום האופציונלי של תא הטבלה אם הטקסט יימחק מתא הטבלה. אם השדה קיים, ה-ObjectId חייב להתייחס לטבלה.

textRange

object (Range)

טווח הטקסט למחיקה, על סמך TextElement אינדקסים.

בסוף הטקסט של צורה או תא בטבלה תמיד יש תו מרומז חדש שלא ניתן למחוק. Range.Type.ALL ישתמש בגבולות הנכונים, אבל יש להקפיד על הגדרה של גבולות מפורשים לסוגים של טווחים FROM_START_INDEX ו-FIXED_RANGE. לדוגמה, אם הטקסט הוא "ABC" ואחריו שורה חדשה משתמעת, הערך המקסימלי יהיה 2 עבור textRange.start_index ו-3 עבור textRange.end_index.

מחיקת טקסט שחוצה גבול של פסקה עשויה לגרום לשינויים בסגנונות וברשימות של פסקאות בעת מיזוג שתי הפסקאות.

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

טווח

המדיניות מציינת טווח רציף של אוסף שנוסף לאינדקס, כמו תווים בטקסט.

ייצוג JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "type": enum (Type)
}
שדות
startIndex

integer

אינדקס אופציונלי מבוסס-אפס מתחילת תחילת האוסף. חובה בטווחים FIXED_RANGE ו-FROM_START_INDEX.

endIndex

integer

אינדקס אופציונלי מבוסס-אפס בסוף האוסף. חובה עבור FIXED_RANGE טווחים.

type

enum (Type)

סוג הטווח.

Type

סוגי הטווחים.

טיפוסים בני מנייה (enum)
RANGE_TYPE_UNSPECIFIED סוג טווח לא צוין. אין להשתמש בערך הזה.
FIXED_RANGE טווח קבוע. יש לציין את startIndex וגם את endIndex.
FROM_START_INDEX מתחיל את הטווח ב-startIndex וממשיך עד סוף האוסף. לא ניתן לציין את endIndex.
ALL מגדיר את הטווח כאורך המלא של האוסף. אין לציין את startIndex וגם את endIndex.

CreateImageRequest

יצירת תמונה.

ייצוג JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}
שדות
objectId

string

מזהה אובייקט שסופק על ידי המשתמש.

אם מציינים מזהה, הוא צריך להיות ייחודי בין כל הדפים ורכיבי הדפים במצגת. המזהה חייב להתחיל בתו אלפאנומרי או בקו תחתון (תואם לביטוי רגולרי [a-zA-Z0-9_]); התווים הנותרים חייבים לכלול מקף או נקודתיים (תואם לביטוי רגולרי [a-zA-Z0-9_-:]). האורך של המזהה לא יכול להיות קצר מ-5 או גדול מ-50.

אם לא תציינו מזהה, ייווצר מזהה ייחודי.

elementProperties

object (PageElementProperties)

מאפייני הרכיב של התמונה.

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

המאפיין PageElementProperties.size הוא אופציונלי. אם לא מציינים את הגודל, ייעשה שימוש בגודל ברירת המחדל של התמונה.

המאפיין PageElementProperties.transform הוא אופציונלי. אם לא תגדירו טרנספורמציה, התמונה תמוקם בפינה הימנית העליונה של הדף.

שדה איחוד image_source. סוג מקור התמונה. image_source יכול להיות רק אחד מהבאים:
url

string

כתובת ה-URL של התמונה.

התמונה מאוחזרת פעם אחת בזמן ההוספה, ועותק נשמר לתצוגה בתוך המצגת. התמונות צריכות להיות קטנות מ-50MB ובגודל של עד 25 מגה פיקסל. הן צריכות להיות בפורמט PNG, JPEG או GIF.

כתובת ה-URL שצוינה חייבת להיות נגישה לכולם, ואורכה יכול להיות 2KB. כתובת ה-URL נשמרת עם התמונה, ונחשפת דרך השדה Image.source_url.

בקשת VideoVideo

יצירת סרטון.

הערה: כשיוצרים סרטון מ-Google Drive, צריך לוודא שהאפליקציה המבקשת כוללת לפחות אחד מהיקפי ההרשאות של Drive, drive.readonly או drive.file מסוג OAuth.

ייצוג JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "source": enum (Source),
  "id": string
}
שדות
objectId

string

מזהה אובייקט שסופק על ידי המשתמש.

אם מציינים מזהה, הוא צריך להיות ייחודי בין כל הדפים ורכיבי הדפים במצגת. המזהה חייב להתחיל בתו אלפאנומרי או בקו תחתון (תואם לביטוי רגולרי [a-zA-Z0-9_]); התווים הנותרים חייבים לכלול מקף או נקודתיים (תואם לביטוי רגולרי [a-zA-Z0-9_-:]). האורך של המזהה לא יכול להיות קצר מ-5 או גדול מ-50.

אם לא תציינו מזהה, ייווצר מזהה ייחודי.

elementProperties

object (PageElementProperties)

מאפייני הרכיב של הסרטון.

המאפיין PageElementProperties.size הוא אופציונלי. אם לא מציינים גודל, השרת בוחר גודל ברירת מחדל.

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

source

enum (Source)

מקור הסרטון.

id

string

המזהה הייחודי של מקור הסרטון.

למשל, בסרטון של YouTube https://www.youtube.com/watch?v=7U3axjORYZ0, המזהה הוא 7U3axjORYZ0. בסרטון ב-Google Drive https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q המזהה הוא 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q.

כדי לגשת לקובץ וידאו ב-Google Drive, ייתכן שתצטרכו להוסיף מפתח משאב לכותרת ה-HTTP של קבוצת משנה של קבצים ישנים. מידע נוסף זמין במאמר גישה לקבצים ששותפו באמצעות קישורים באמצעות מפתחות משאבים.

CreateSheetsChartRequest

יצירת תרשים הטמעת של Google Sheets.

הערה: ליצירת תרשים נדרש לפחות אחד מההיקפים של spreadsheets.readonly, sheets , drive.readonly, drive.file או Drive של היקפי OAuth.

ייצוג JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode)
}
שדות
objectId

string

מזהה אובייקט שסופק על ידי המשתמש.

אם צוין, המזהה חייב להיות ייחודי בין כל הדפים ורכיבי הדפים במצגת. המזהה צריך להתחיל בתו של מילה [a-zA-Z0-9_] ואחריו כל אחד מהתווים הבאים [a-zA-Z0-9_-:]. האורך של המזהה לא יכול להיות קצר מ-5 או גדול מ-50. אם השדה ריק, המערכת תיצור מזהה ייחודי.

elementProperties

object (PageElementProperties)

מאפייני הרכיב בתרשים.

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

spreadsheetId

string

המזהה של הגיליון האלקטרוני ב-Google Sheets שמכיל את התרשים.

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

chartId

integer

המזהה של התרשים הספציפי בגיליון האלקטרוני של Google Sheets.

linkingMode

enum (LinkingMode)

המצב שבו התרשים מקושר לגיליון האלקטרוני המקורי. אם לא צוין אחרת, התרשים יהיה תמונה שאינה מקושרת.

מצב קישור

המצב שבו התרשים מקושר לגיליון האלקטרוני המקורי.

טיפוסים בני מנייה (enum)
NOT_LINKED_IMAGE התרשים לא משויך לגיליון האלקטרוני המקורי ולא ניתן לעדכן אותו. תרשים שלא מקושר אליו יתווסף כתמונה.
LINKED קישור התרשים מאפשר את עדכוןו, ושותפי עריכה אחרים יראו קישור לגיליון האלקטרוני.

CreateLineRequest

יוצר קו.

ייצוג JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "lineCategory": enum (Category),
  "category": enum (LineCategory)
}
שדות
objectId

string

מזהה אובייקט שסופק על ידי המשתמש.

אם מציינים מזהה, הוא צריך להיות ייחודי בין כל הדפים ורכיבי הדפים במצגת. המזהה חייב להתחיל בתו אלפאנומרי או בקו תחתון (תואם לביטוי רגולרי [a-zA-Z0-9_]); התווים הנותרים חייבים לכלול מקף או נקודתיים (תואם לביטוי רגולרי [a-zA-Z0-9_-:]). האורך של המזהה לא יכול להיות קצר מ-5 או גדול מ-50.

אם לא תציינו מזהה, ייווצר מזהה ייחודי.

elementProperties

object (PageElementProperties)

מאפייני הרכיב שבשורה.

lineCategory
(deprecated)

enum (Category)

הקטגוריה של הקו שצריך ליצור.

הוצאה משימוש : במקומה יש להשתמש באפשרות category.

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

אם מציינים גם category וגם lineCategory, ה-category מקבל עדיפות.

category

enum (LineCategory)

הקטגוריה של הקו שצריך ליצור.

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

אם מציינים גם category וגם lineCategory, ה-category מקבל עדיפות.

אם לא מציינים ערך עבור category, אבל מציינים ערך עבור lineCategory, המערכת תשתמש בערך lineCategory שצוין.

אם לא מציינים שום דבר, נעשה שימוש ב- STRAIGHT.

קטגוריה

הקטגוריות של השורות.

טיפוסים בני מנייה (enum)
STRAIGHT מחברים ישרים, כולל מחבר ישר 1. זוהי קטגוריית ברירת המחדל, אם לא צוינה קטגוריה.
BENT מחברי כיפוף, כולל מחבר מכופף 2 עד 5.
CURVED מחברים מתעקלים, כולל מחבר מעוקל 2 עד 5.

רענון SheetsChartRequest

מרענן תרשים מוטמע של Google Sheets על ידי החלפתו בגרסה האחרונה של התרשים מ-Google Sheets.

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

ייצוג JSON 
{
  "objectId": string
}
שדות
objectId

string

מזהה האובייקט של התרשים לרענון.

עדכון DesignFormsRequest

יש לעדכן את המאפיינים של Shape.

ייצוג JSON 
{
  "objectId": string,
  "shapeProperties": {
    object (ShapeProperties)
  },
  "fields": string
}
שדות
objectId

string

מזהה האובייקט של הצורה שעליה מתבצעים העדכונים.

shapeProperties

object (ShapeProperties)

מאפייני הצורה שצריך לעדכן.

fields

string (FieldMask format)

השדות שצריך לעדכן.

יש לציין לפחות שדה אחד. השורש shapeProperties הוא משתמע ואין לציין אותו. ניתן להשתמש ב-"*" כקצרים כדי לרשום את כל השדות.

לדוגמה, כדי לעדכן את צבע המילוי המלא של רקע הצורה, מגדירים את הערך fields לערך "shapeBackgroundFill.solidFill.color".

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

עדכון ImageImageRequest

יש לעדכן את המאפיינים של Image.

ייצוג JSON 
{
  "objectId": string,
  "imageProperties": {
    object (ImageProperties)
  },
  "fields": string
}
שדות
objectId

string

מזהה האובייקט של התמונה, שאליה חלים העדכונים.

imageProperties

object (ImageProperties)

מאפייני התמונה שצריך לעדכן.

fields

string (FieldMask format)

השדות שצריך לעדכן.

יש לציין לפחות שדה אחד. השורש imageProperties הוא משתמע ואין לציין אותו. ניתן להשתמש ב-"*" כקצרים כדי לרשום את כל השדות.

לדוגמה, כדי לעדכן את צבע המתאר של התמונה, מגדירים את הערך fields לערך "outline.outlineFill.solidFill.color".

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

עדכון VideoUpdateRequest

יש לעדכן את המאפיינים של Video.

ייצוג JSON 
{
  "objectId": string,
  "videoProperties": {
    object (VideoProperties)
  },
  "fields": string
}
שדות
objectId

string

מזהה האובייקט של הסרטון שעליו חלים העדכונים.

videoProperties

object (VideoProperties)

מאפייני הסרטון לעדכון.

fields

string (FieldMask format)

השדות שצריך לעדכן.

יש לציין לפחות שדה אחד. השורש videoProperties הוא משתמע ואין לציין אותו. ניתן להשתמש ב-"*" כקצרים כדי לרשום את כל השדות.

לדוגמה, כדי לעדכן את צבע מתאר הסרטון, מגדירים את הערך fields לערך "outline.outlineFill.solidFill.color".

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

עדכון דף המאפיינים

עדכון המאפיינים של Page.

ייצוג JSON 
{
  "objectId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "fields": string
}
שדות
objectId

string

מזהה האובייקט של הדף שעליו חל העדכון.

pageProperties

object (PageProperties)

מאפייני הדף שיש לעדכן.

fields

string (FieldMask format)

השדות שצריך לעדכן.

יש לציין לפחות שדה אחד. השורש pageProperties הוא משתמע ואין לציין אותו. ניתן להשתמש ב-"*" כקצרים כדי לרשום את כל השדות.

לדוגמה, כדי לעדכן את צבע המילוי המלא של רקע הדף, מגדירים את הערך fields לערך "pageBackgroundFill.solidFill.color".

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

עדכוןTTCCllllPropertiesRequest

יש לעדכן את המאפיינים של TableCell.

ייצוג JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "tableCellProperties": {
    object (TableCellProperties)
  },
  "fields": string
}
שדות
objectId

string

מזהה האובייקט של הטבלה.

tableRange

object (TableRange)

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

tableCellProperties

object (TableCellProperties)

המאפיינים של תא הטבלה שיש לעדכן.

fields

string (FieldMask format)

השדות שצריך לעדכן.

יש לציין לפחות שדה אחד. השורש tableCellProperties הוא משתמע ואין לציין אותו. ניתן להשתמש ב-"*" כקצרים כדי לרשום את כל השדות.

לדוגמה, כדי לעדכן את צבע המילוי של רקע התא בטבלה, מגדירים את הערך fields לערך "tableCellBackgroundFill.solidFill.color".

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

טווח טבלאות

טווח של טבלה מייצג הפניה לקבוצת משנה של טבלה.

חשוב לציין שהתאים שצוינו בטווח טבלאות לא בהכרח יוצרים מלבן. לדוגמה, נניח שיש לנו טבלה בגודל 3 x 3, שבה כל התאים של השורה האחרונה ממוזגים יחד. הטבלה נראית כך: 

 [   ][   ][   ]
 [   ][   ][   ]
 [             ]

טווח בטבלה עם מיקום = (0, 0), שורה span = 3 ועמודה עמודה = 2 מציין את התאים הבאים: 

 [ x ][ x ][   ]
 [ x ][ x ][   ]
 [ x    x    x ]
ייצוג JSON 
{
  "location": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
שדות
location

object (TableCellLocation)

המיקום ההתחלתי של טווח הטבלאות.

rowSpan

integer

אורך השורה של טווח הטבלה.

columnSpan

integer

טווח העמודות של טווח הטבלה.

עדכון LineLineProperties

עדכון המאפיינים של Line.

ייצוג JSON 
{
  "objectId": string,
  "lineProperties": {
    object (LineProperties)
  },
  "fields": string
}
שדות
objectId

string

מזהה האובייקט של השורה שעליה חל העדכון.

lineProperties

object (LineProperties)

מאפייני הקו שיש לעדכן.

fields

string (FieldMask format)

השדות שצריך לעדכן.

יש לציין לפחות שדה אחד. השורש lineProperties הוא משתמע ואין לציין אותו. ניתן להשתמש ב-"*" כקצרים כדי לרשום את כל השדות.

לדוגמה, כדי לעדכן את צבע המילוי המלא של הקו, מגדירים את הערך fields כ-"lineFill.solidFill.color".

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

CreateParagraphbulletsRequest

יוצרת תבליטים לכל הפסקאות שחופפות לטווח הנתון של אינדקס הטקסט.

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

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

ייצוג JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
שדות
objectId

string

מזהה האובייקט של הצורה או הטבלה שמכילים את הטקסט להוספת תבליטים.

cellLocation

object (TableCellLocation)

המיקום האופציונלי של תא הטבלה אם הטקסט שיש לשנות נמצא בתא בטבלה. אם השדה קיים, ה-ObjectId חייב להתייחס לטבלה.

textRange

object (Range)

טווח הטקסט שעליו יש להחיל את הערכים הקבועים מראש, על סמך TextElement אינדקסים.

bulletPreset

enum (BulletGlyphPreset)

סוגי הגליפים של התבליטים שבהם יש להשתמש. ברירת המחדל היא BULLET_DISC_CIRCLE_SQUARE ההגדרה הקבועה מראש.

תבליט Greset

תבניות מוגדרות מראש של גליפים של תבליטים ברשימות ברשימות.

בתבניות האלה נעשה שימוש בתבליטים מהסוגים הבאים:

  • ARROW : חץ, שתואם לנקודת קוד Unicode U+2794
  • ARROW3D : חץ עם הצללה תלת-ממדית, בהתאם לנקודת הקוד Unicode U+27a2
  • CHECKBOX : ריבוע ריק, שתואם לנקודת קוד Unicode U+274f
  • CIRCLE : עיגול חלול שתואם לנקודת הקוד Unicode U+25cb
  • DIAMOND : יהלום מלא, שתואם לנקודת קוד Unicode U+25c6
  • DIAMONDX : יהלום עם 'x', תואם לנקודת קוד Unicode U+2756
  • HOLLOWDIAMOND : יהלום חלול, שתואם לנקודת קוד Unicode U+25c7
  • DISC : עיגול יציב, התואם לנקודת קוד Unicode U+25cf
  • SQUARE : ריבוע מלא, שתואם לנקודת הקוד של Unicode U+25a0
  • STAR : כוכב, שתואם לנקודת קוד Unicode U+2605
  • ALPHA : אות קטנה, כמו 'a', 'b' או 'c'.
  • UPPERALPHA : אות גדולה, כמו 'A', 'B' או 'C'.
  • DIGIT : מספר, כמו '1', '2' או '3'.
  • ZERODIGIT : מספר הכולל ספרות בודדות עם קידומת אפס, למשל '01', '02' או '03'. מספרים בעלי יותר מספרה אחת אינם קידומת של אפס.
  • ROMAN : ספרה רומית קטנה, כמו 'i', 'ii' או 'iii'.
  • UPPERROMAN : ספרה רומית גדולה, כמו 'I', 'II' או 'III'.
  • LEFTTRIANGLE : משולש שמצביע שמאלה, בהתאם לנקודה בקוד Unicode U+25c4
טיפוסים בני מנייה (enum)
BULLET_DISC_CIRCLE_SQUARE רשימת תבליטים עם תבליט תבליטים מסוג DISC, CIRCLE ו-SQUARE ל-3 רמות הסידור הראשונות של הרשימות.
BULLET_DIAMONDX_ARROW3D_SQUARE רשימת תבליטים עם תבליט תבליטים מסוג DIAMONDX, ARROW3D ו-SQUARE ל-3 רמות הסידור הראשונות של הרשימות.
BULLET_CHECKBOX רשימת תבליטים עם CHECKBOX גליפים של תבליטים לכל הרמות של קינון הרשימות.
BULLET_ARROW_DIAMOND_DISC רשימת תבליטים עם תבליט תבליטים מסוג ARROW, DIAMOND ו-DISC ל-3 רמות הסידור הראשונות של הרשימות.
BULLET_STAR_CIRCLE_SQUARE רשימת תבליטים עם תבליט תבליטים מסוג STAR, CIRCLE ו-SQUARE ל-3 רמות הסידור הראשונות של הרשימות.
BULLET_ARROW3D_CIRCLE_SQUARE רשימת תבליטים עם תבליט תבליטים מסוג ARROW3D, CIRCLE ו-SQUARE ל-3 רמות הסידור הראשונות של הרשימות.
BULLET_LEFTTRIANGLE_DIAMOND_DISC רשימת תבליטים עם תבליט תבליטים מסוג LEFTTRIANGLE, DIAMOND ו-DISC ל-3 רמות הסידור הראשונות של הרשימות.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE רשימת תבליטים עם תבליט תבליטים מסוג DIAMONDX, HOLLOWDIAMOND ו-SQUARE ל-3 רמות הסידור הראשונות של הרשימות.
BULLET_DIAMOND_CIRCLE_SQUARE רשימת תבליטים עם תבליט תבליטים מסוג DIAMOND, CIRCLE ו-SQUARE ל-3 רמות הסידור הראשונות של הרשימות.
NUMBERED_DIGIT_ALPHA_ROMAN רשימה ממוספרת עם DIGIT, ALPHA ו-ROMAN גליפים מספריים עבור 3 הרמות הראשונות של סידור הרשימות, ולאחר מכן נקודות.
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS רשימה ממוספרת עם DIGIT, ALPHA ו-ROMAN גליפים מספריים ל-3 רמות הסידור הראשונות של הרשימות, ואחריה סוגריים.
NUMBERED_DIGIT_NESTED רשימה ממוספרת עם DIGIT גליפים מספריים המופרדים בנקודות, כאשר כל רמת קינון משתמשת בגליף של רמת הדירוג הקודמת כקידומת. לדוגמה: '1.', '1.1.', '2.', '2.2'.
NUMBERED_UPPERALPHA_ALPHA_ROMAN רשימה ממוספרת עם UPPERALPHA, ALPHA ו-ROMAN גליפים מספריים עבור 3 הרמות הראשונות של סידור הרשימות, ולאחר מכן נקודות.
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT רשימה ממוספרת עם UPPERROMAN, UPPERALPHA ו-DIGIT גליפים מספריים עבור 3 הרמות הראשונות של סידור הרשימות, ולאחר מכן נקודות.
NUMBERED_ZERODIGIT_ALPHA_ROMAN רשימה ממוספרת עם ZERODIGIT, ALPHA ו-ROMAN גליפים מספריים עבור 3 הרמות הראשונות של סידור הרשימות, ולאחר מכן נקודות.

החלפת כל הצורות עם ImageRequest

החלפת כל הצורות שתואמות לקריטריונים הנתונים בתמונה שסופקה.

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

ייצוג JSON 
{
  "replaceMethod": enum (ReplaceMethod),
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "pageObjectIds": [
    string
  ],

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.

  // Union field image_source can be only one of the following:
  "imageUrl": string
  // End of list of possible types for union field image_source.
}
שדות
replaceMethod
(deprecated)

enum (ReplaceMethod)

שיטת ההחלפה.

הוצאה משימוש : במקומה יש להשתמש באפשרות imageReplaceMethod.

אם ציינת את השדה replaceMethod וגם את הערך imageReplaceMethod, הערך imageReplaceMethod יקבל עדיפות.

imageReplaceMethod

enum (ImageReplaceMethod)

שיטת החלפת התמונות.

אם ציינת את השדה replaceMethod וגם את הערך imageReplaceMethod, הערך imageReplaceMethod יקבל עדיפות.

אם לא מציינים ערך עבור imageReplaceMethod, אבל מציינים ערך עבור replaceMethod, המערכת תשתמש בערך replaceMethod שצוין.

אם לא ציינת ערכים, ייעשה שימוש ב-CENTER_INSIDE.

pageObjectIds[]

string

אם לא ריק, מגביל את ההתאמות לרכיבי דף רק בדפים הנתונים.

מחזירה שגיאת 400 של בקשה שגויה אם מקבלים את מזהה אובייקט הדף של notes page או notes master, או אם דף עם מזהה האובייקט לא קיים במצגת.

שדה איחוד criteria. הקריטריונים שהצורות צריכות להתאים להן כדי שיוחלפו. criteria יכול להיות רק אחד מהבאים:
containsText

object (SubstringMatchCriteria)

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

שדה איחוד image_source. סוג מקור התמונה. image_source יכול להיות רק אחד מהבאים:
imageUrl

string

כתובת ה-URL של התמונה.

התמונה מאוחזרת פעם אחת בזמן ההוספה, ועותק נשמר לתצוגה בתוך המצגת. התמונות חייבות להיות קטנות מ-50MB והגודל שלהן לא יכול לחרוג מ-25 מגה פיקסל. הן צריכות להיות בפורמט PNG, JPEG או GIF.

כתובת ה-URL שצוינה יכולה להיות באורך של 2KB לכל היותר. כתובת ה-URL עצמה נשמרת עם התמונה ונחשף באמצעות השדה Image.source_url.

שיטת החלפה

שיטת ההחלפה.

טיפוסים בני מנייה (enum)
CENTER_INSIDE גודל התמונה משתנה ומרכז אותה לגבולות של הצורה המקורית ושומר על יחס הגובה-רוחב של התמונה. ייתכן שהגודל של התמונה לאחר עיבוד יהיה קטן יותר מצורת הצורה. זוהי שיטת ברירת המחדל כאשר לא מצוין ערך.
CENTER_CROP שינוי הגודל והמרכז של התמונה כדי למלא את הגבולות של הצורה המקורית. יכול להיות שהתמונה תיחתך כדי למלא את הצורה. הגודל של התמונה המעובד יהיה זהה לזה של הצורה המקורית.

שיטת החלפת התמונה

שיטת החלפת התמונות.

טיפוסים בני מנייה (enum)
IMAGE_REPLACE_METHOD_UNSPECIFIED שיטה לא מוגדרת להחלפת תמונות. אין להשתמש בערך הזה.
CENTER_INSIDE גודל התמונה משתנה ומרכז אותה לגבולות של הצורה המקורית ושומר על יחס הגובה-רוחב של התמונה. ייתכן שהגודל של התמונה לאחר עיבוד יהיה קטן יותר מצורת הצורה. זוהי שיטת ברירת המחדל כאשר לא מצוין ערך.
CENTER_CROP שינוי הגודל והמרכז של התמונה כדי למלא את הגבולות של הצורה המקורית. יכול להיות שהתמונה תיחתך כדי למלא את הצורה. הגודל של התמונה המעובד יהיה זהה לצורתו המקורית.

בקשה כפולה של אובייקט

משכפל שקף או רכיב דף.

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

ייצוג JSON 
{
  "objectId": string,
  "objectIds": {
    string: string,
    ...
  }
}
שדות
objectId

string

מזהה האובייקט לשכפול.

objectIds

map (key: string, value: string)

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

כל המפתחות חייבים להתאים למזהים הקיימים במצגת. כל הערכים חייבים להיות ייחודיים במצגת, והם חייבים להתחיל בתו אלפאנומרי או בקו תחתון (תואם לביטוי הרגולרי [a-zA-Z0-9_]). התווים הנותרים יכולים לכלול גם מקף או נקודתיים (תואם לביטוי רגולרי [a-zA-Z0-9_-:]). האורך של המזהה החדש לא יכול להיות קצר מ-5 או גדול מ-50.

אם מזהים כלשהם של אובייקטי מקור מושמטים מהמפה, יוקצה מזהה אקראי חדש. אם המפה ריקה או לא מוגדרת, כל האובייקטים הכפולים יקבלו מזהה אקראי חדש.

עדכון TextTextStyle

צריך לעדכן את סגנון הטקסט באחד Shape או Table.

ייצוג JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (TextStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
שדות
objectId

string

מזהה האובייקט של הצורה או הטבלה שמכילות את הטקסט לעיצוב.

cellLocation

object (TableCellLocation)

מיקום התא בטבלה שמכיל את הטקסט לעיצוב. אם objectId מתייחס לטבלה, cellLocation חייב להכיל ערך. אם לא, יש לעשות זאת.

style

object (TextStyle)

הסגנונות שרוצים להגדיר בטקסט.

אם הערך של סגנון מסוים תואם לזה של ההורה, הסגנון הזה יקבל בירושה.

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

textRange

object (Range)

טווח הטקסט לעיצוב.

ניתן להרחיב את הטווח כך שיכלול שורות חדשות סמוכות.

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

fields

string (FieldMask format)

השדות שצריך לעדכן.

יש לציין לפחות שדה אחד. השורש style הוא משתמע ואין לציין אותו. ניתן להשתמש ב-"*" כקצרים כדי לרשום את כל השדות.

לדוגמה, כדי לעדכן את סגנון הטקסט למודגש, צריך להגדיר את הערך fields לערך "bold".

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

החלפת כל הצורות עם SheetsChartRequest

החלפת כל הצורות שתואמות לקריטריונים שהוגדרו בתרשים Google Sheets שצוין. התרשים יוגדל ומרכז כך שיתאים לגבולות של הצורה המקורית.

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

ייצוג JSON 
{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}
שדות
containsText

object (SubstringMatchCriteria)

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

spreadsheetId

string

המזהה של הגיליון האלקטרוני ב-Google Sheets שמכיל את התרשים.

chartId

integer

המזהה של התרשים הספציפי בגיליון האלקטרוני של Google Sheets.

linkingMode

enum (LinkingMode)

המצב שבו התרשים מקושר לגיליון האלקטרוני המקורי. אם לא צוין אחרת, התרשים יהיה תמונה שאינה מקושרת.

pageObjectIds[]

string

אם לא ריק, מגביל את ההתאמות לרכיבי דף רק בדפים הנתונים.

מחזירה שגיאת 400 של בקשה שגויה אם מקבלים את מזהה אובייקט הדף של notes page או notes master, או אם דף עם מזהה האובייקט לא קיים במצגת.

מצב קישור

המצב שבו התרשים מקושר לגיליון האלקטרוני המקורי.

טיפוסים בני מנייה (enum)
NOT_LINKED_IMAGE התרשים לא משויך לגיליון האלקטרוני המקורי ולא ניתן לעדכן אותו. תרשים שלא מקושר אליו יתווסף כתמונה.
LINKED קישור התרשים מאפשר את עדכוןו, ושותפי עריכה אחרים יראו קישור לגיליון האלקטרוני.

DeleteParagraphbulletsRequest

מחיקת תבליטים מכל הפסקאות שחופפות לאינדקס הטקסט הנתון range.

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

ייצוג JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
שדות
objectId

string

מזהה האובייקט של הצורה או הטבלה שמכילות את הטקסט שממנו יימחקו תבליטים.

cellLocation

object (TableCellLocation)

המיקום האופציונלי של תא הטבלה אם הטקסט שיש לשנות נמצא בתא בטבלה. אם השדה קיים, ה-ObjectId חייב להתייחס לטבלה.

textRange

object (Range)

טווח הטקסט של מחיקת תבליטים, על סמך TextElement אינדקסים.

עדכוןParagraphStyleRequest

עדכון הסגנון של כל הפסקאות בטווח של Shape או Table שחופפים לטווח הנתון של אינדקס הטקסט.

ייצוג JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (ParagraphStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
שדות
objectId

string

מזהה האובייקט של הצורה או הטבלה שמכילות את הטקסט לעיצוב.

cellLocation

object (TableCellLocation)

המיקום של התא בטבלה שמכיל את הפסקאות שרוצים לעצב. אם objectId מתייחס לטבלה, cellLocation חייב להכיל ערך. אם לא, יש לעשות זאת.

style

object (ParagraphStyle)

הסגנון של הפסקה.

textRange

object (Range)

טווח הטקסט בסגנון של הפסקה.

fields

string (FieldMask format)

השדות שצריך לעדכן.

יש לציין לפחות שדה אחד. השורש style הוא משתמע ואין לציין אותו. ניתן להשתמש ב-"*" כקצרים כדי לרשום את כל השדות.

לדוגמה, כדי לעדכן את יישור הפסקה, מגדירים את fields לערך "alignment".

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

עדכוןTTBorderPropertiesRequest

עדכון המאפיינים של גבולות הטבלה בTable.

ייצוג JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "borderPosition": enum (BorderPosition),
  "tableBorderProperties": {
    object (TableBorderProperties)
  },
  "fields": string
}
שדות
objectId

string

מזהה האובייקט של הטבלה.

tableRange

object (TableRange)

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

borderPosition

enum (BorderPosition)

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

tableBorderProperties

object (TableBorderProperties)

המאפיינים של גבול הטבלה שיש לעדכן.

fields

string (FieldMask format)

השדות שצריך לעדכן.

יש לציין לפחות שדה אחד. השורש tableBorderProperties הוא משתמע ואין לציין אותו. ניתן להשתמש ב-"*" כקצרים כדי לרשום את כל השדות.

לדוגמה, כדי לעדכן את צבע המילוי המלא של גבול הטבלה, מגדירים את הערך fields לערך "tableBorderFill.solidFill.color".

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

מיקום גבול

המיקום של גבול הטבלה.

טיפוסים בני מנייה (enum)
ALL כל הגבולות בטווח.
BOTTOM גבולות בתחתית הטווח.
INNER גבולות בתוך הטווח.
INNER_HORIZONTAL גבולות אופקיים בתוך הטווח.
INNER_VERTICAL גבולות אנכיים בתוך הטווח.
LEFT גבולות מימין לטווח.
OUTER גבולות מחוץ לטווח.
RIGHT גבולות משמאל לטווח.
TOP גבולות בחלק העליון של הטווח.

עדכוןTTColumnColumnRequest

עדכון המאפיינים בעמודה Table.

ייצוג JSON 
{
  "objectId": string,
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
שדות
objectId

string

מזהה האובייקט של הטבלה.

columnIndices[]

integer

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

tableColumnProperties

object (TableColumnProperties)

המאפיינים של עמודת הטבלה שיש לעדכן.

אם הערך של tableColumnProperties#columnWidth בבקשה נמוך מ-406,400 EMU (32 נקודות), מוחזרת שגיאה 400 בבקשה.

fields

string (FieldMask format)

השדות שצריך לעדכן.

יש לציין לפחות שדה אחד. השורש tableColumnProperties הוא משתמע ואין לציין אותו. ניתן להשתמש ב-"*" כקצרים כדי לרשום את כל השדות.

לדוגמה, כדי לעדכן את רוחב העמודה, מגדירים את fields לערך "columnWidth".

אם ''ColumnWidth'' כלול במסכה של השדה אך המאפיין לא מוגדר, רוחב העמודה יהיה ברירת המחדל ל-406,400 EMU (32 נקודות).

UpdateTableRowPropertiesRequest

עדכון המאפיינים של שורה Table.

ייצוג JSON 
{
  "objectId": string,
  "rowIndices": [
    integer
  ],
  "tableRowProperties": {
    object (TableRowProperties)
  },
  "fields": string
}
שדות
objectId

string

מזהה האובייקט של הטבלה.

rowIndices[]

integer

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

tableRowProperties

object (TableRowProperties)

המאפיינים של שורת הטבלה שיש לעדכן.

fields

string (FieldMask format)

השדות שצריך לעדכן.

יש לציין לפחות שדה אחד. השורש tableRowProperties הוא משתמע ואין לציין אותו. ניתן להשתמש ב-"*" כקצרים כדי לרשום את כל השדות.

למשל, כדי לעדכן את גובה השורה המינימלי, מגדירים את הערך fields לערך "minRowHeight".

אם 'minRowHeight' כלול במסכה של השדה אבל המאפיין לא מוגדר, גובה השורה המינימלי יהיה 0 כברירת מחדל.

בקשת MergeTableCellsRequest

מיזוג תאים בתוך Table.

ייצוג JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
שדות
objectId

string

מזהה האובייקט של הטבלה.

tableRange

object (TableRange)

טווח הטבלה שמציין אילו תאים בטבלה יש למזג.

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

ביטול המיזוג של בקשה

ביטול המיזוג של תאים ב-Table.

ייצוג JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
שדות
objectId

string

מזהה האובייקט של הטבלה.

tableRange

object (TableRange)

טווח הטבלה שמציין אילו תאים בטבלה יש לבטל.

כל התאים שמוזגו בטווח הזה לא ימוזגו, ותאים שכבר לא מוזגו לא יושפעו. אם בטווח אין תאים שמוזגו, הבקשה לא תעשה דבר. אם יש טקסט באחד מהתאים שמוזגו, הטקסט יישאר בתא השמאלי העליון ("head") של הבלוק שמתקבל מהמיזוג של התאים.

אובייקט קבוצתי

מקבצת אובייקטים כדי ליצור קבוצת אובייקטים. לדוגמה, קיבוץ PageElements כדי ליצור Group באותו דף יחד עם כל הילדים.

ייצוג JSON 
{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}
שדות
groupObjectId

string

מזהה אובייקט שסופק על ידי המשתמש ויצור את הקבוצה.

אם מציינים מזהה, הוא צריך להיות ייחודי בין כל הדפים ורכיבי הדפים במצגת. המזהה חייב להתחיל בתו אלפאנומרי או בקו תחתון (תואם לביטוי רגולרי [a-zA-Z0-9_]); התווים הנותרים חייבים לכלול מקף או נקודתיים (תואם לביטוי רגולרי [a-zA-Z0-9_-:]). האורך של המזהה לא יכול להיות קצר מ-5 או גדול מ-50.

אם לא תציינו מזהה, ייווצר מזהה ייחודי.

childrenObjectIds[]

string

מזהי האובייקטים של האובייקטים שיש לקבץ.

אפשר לקבץ רק רכיבים בדף. בכל דף צריכים להיות לפחות שני רכיבים שלא שייכים לקבוצה אחרת. אי אפשר לקבץ חלק מרכיבי הדף, כמו videos, tables ו-placeholders.

ביטול הקיבוץ של בקשה

ביטול הקיבוץ של אובייקטים, כמו groups.

ייצוג JSON 
{
  "objectIds": [
    string
  ]
}
שדות
objectIds[]

string

מזהי האובייקטים לקיבוץ.

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

עדכון PageElementAltTextRequest

עדכון השם או התיאור של הטקסט החלופי ב-page element.

ייצוג JSON 
{
  "objectId": string,
  "title": string,
  "description": string
}
שדות
objectId

string

מזהה האובייקט של רכיב הדף שעליו העדכונים חלים.

title

string

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

description

string

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

החלפת תמונה

מחליפה תמונה קיימת בתמונה חדשה.

החלפת תמונה גורמת להסרת image effects מהתמונה הקיימת.

ייצוג JSON 
{
  "imageObjectId": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}
שדות
imageObjectId

string

המזהה של התמונה הקיימת שיוחלף. ניתן לאחזר את המזהה מהתשובה של בקשת אחזור.

imageReplaceMethod

enum (ImageReplaceMethod)

שיטת ההחלפה.

שדה איחוד image_source. סוג מקור התמונה. image_source יכול להיות רק אחד מהבאים:
url

string

כתובת ה-URL של התמונה.

התמונה מאוחזרת פעם אחת בזמן ההוספה, ועותק נשמר לתצוגה בתוך המצגת. התמונות חייבות להיות קטנות מ-50MB ובגודל של עד 25 מגה פיקסל. הן צריכות להיות בפורמט PNG, JPEG או GIF.

כתובת ה-URL שסופקה לא יכולה לחרוג מ- 2KB. כתובת ה-URL נשמרת עם התמונה, ונחשפת דרך השדה Image.source_url.

UpdateSlidePropertiesRequest

עדכון המאפיינים של שקף.

ייצוג JSON 
{
  "objectId": string,
  "slideProperties": {
    object (SlideProperties)
  },
  "fields": string
}
שדות
objectId

string

מזהה האובייקט של השקף שעליו חל העדכון.

slideProperties

object (SlideProperties)

מאפייני השקף שיש לעדכן.

fields

string (FieldMask format)

השדות שצריך לעדכן.

יש לציין לפחות שדה אחד. הרמה הבסיסית 'slideProperties' היא משתמעת ואין לציין אותה. ניתן להשתמש ב-"*" כקצרים כדי לרשום את כל השדות.

לדוגמה, כדי לבדוק אם דילגתם על שקף, מגדירים את fields בתור "isSkipped".

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

UpdatePageElementsZOrderRequest

עדכון סדר ה-Z של רכיבי הדף. סדר ה-Z הוא סדר האלמנטים בדף מההתחלה ועד הסוף. רכיב הדף בחזית עשוי לכלול את הרכיבים שמאחוריו.

ייצוג JSON 
{
  "pageElementObjectIds": [
    string
  ],
  "operation": enum (ZOrderOperation)
}
שדות
pageElementObjectIds[]

string

מזהי האובייקטים של רכיבי הדף שיש לעדכן.

כל רכיבי הדף חייבים להיות באותו הדף ואסור לקבץ אותם.

operation

enum (ZOrderOperation)

פעולה בסדר Z שצריך להחיל על רכיבי הדף.

כשמחילים את הפעולה על מספר רכיבי דף, פקודות ה-Z היחסיות בתוך רכיבי הדף האלה לפני ביצוע הפעולה.

ZOrderOperation

הפעולה לעדכון סידור Z של רכיב דף.

טיפוסים בני מנייה (enum)
Z_ORDER_OPERATION_UNSPECIFIED פעולה לא מוגדרת.
BRING_TO_FRONT מפנה את רכיבי הדף לחלק הקדמי של הדף.
BRING_FORWARD הצגת הרכיבים בדף קדימה ברכיב אחד ביחס לרכיב הקיצוני ביותר ברכיבי הדף שצוינו.
SEND_BACKWARD התג שולח את הרכיבים בדף אחורה ברכיב אחד, ביחס לאחרם ברכיב הדף שצוין.
SEND_TO_BACK שליחת רכיבי הדף לחלקו האחורי של הדף.

עדכון LineLineCategoryRequest

עדכון הקטגוריה של line.

ייצוג JSON 
{
  "objectId": string,
  "lineCategory": enum (LineCategory)
}
שדות
objectId

string

מזהה האובייקט של השורה שעליה חל העדכון.

ניתן לעדכן רק קו עם category שמציין כי הוא "מחבר".

לאחר עדכון הקטגוריה ניתן יהיה לנתב מחדש את הקו.

lineCategory

enum (LineCategory)

קטגוריית הקו שאליה תתבצע העדכון.

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

ניתוב מחדשRequestRequest

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

ייצוג JSON 
{
  "objectId": string
}
שדות
objectId

string

מזהה האובייקט של הנתיב לניתוב מחדש.

ניתן לנתב רק קו עם category שמציין שמדובר ב "מחבר". חיבורי ההתחלה והסיום של הקו חייבים להיות ברכיבים שונים בדף.