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)

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

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

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

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

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

רשימה אופציונלית של מיפויים של מזהי אובייקטים מתוך placeholder (s) בפריסה ל-placeholders שנוצרו בשקף מהפריסה שצוינה. אפשר להשתמש בו רק כשמציינים את הערך slideLayoutReference.

LayoutReference

הפניה לפריסת שקף. האפשרויות הן:

  • פריסה מוגדרת מראש
  • אחת מהפריסות במצגת.
ייצוג ב-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

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

PredefinedLayout

סוגי פריסה מוגדרים מראש. לרוב, הפריסות האלה נפוצות במצגות. עם זאת, אי אפשר להבטיח שהפריסות האלה יופיעו במאסטר הנוכחי כי ייתכן שהן נמחקו או לא חלק מהעיצוב שבו נעשה שימוש. בנוסף, ייתכן ש-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 פריסה עם כותרת של מספר גדול.

LayoutPlaceholderIdMapping

מיפוי המזהה שצוין על ידי המשתמש ל-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 של TITLE עם אינדקס 0 ו-placeholder של BODY עם אינדקס 0.

layoutPlaceholderObjectId

string

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

CreateShapeRequest

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

ייצוג ב-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)

סוג הצורה

PageElementProperties

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

הערה: כשאתם יוצרים 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)

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

text

string

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

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

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

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

insertionIndex

integer

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

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

InsertTableRowsRequest

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

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

string

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

cellLocation

object (TableCellLocation)

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

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

insertBelow

boolean

האם להוסיף שורות חדשות מתחת למיקום של תא העזר.

  • True : צריך להוסיף מתחת לתא.
  • False : הוספה מעל התא.
number

integer

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

InsertTableColumnsRequest

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

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

ייצוג 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)

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

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

ReplaceAllTextRequest

הפונקציה מחליפה את כל המופעים של טקסט שתואם לקריטריונים ב- 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)

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

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)

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

ApplyMode

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

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

UpdateSlidesPositionRequest

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

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

string

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

insertionIndex

integer

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

DeleteTextRequest

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

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

string

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

cellLocation

object (TableCellLocation)

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

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)

סוג הטווח.

סוג

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

טיפוסים בני מנייה (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.

CreateVideoRequest

יצירת סרטון.

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

ייצוג 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.

הערה: כדי ליצור תרשים צריך לפחות אחד מההיקפים של JSON.readonly, גיליונות אלקטרוניים, drive.readonly, drive.file או Drive.

ייצוג 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)

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

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.

RefreshSheetsChartRequest

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

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

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

string

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

UpdateShapePropertiesRequest

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

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

string

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

shapeProperties

object (ShapeProperties)

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

fields

string (FieldMask format)

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

צריך לציין שדה אחד לפחות. הרמה הבסיסית (root) shapeProperties היא משתמעת ואין לציין אותה. סינגל "*" יכולים לשמש כקיצורים לכל שדה.

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

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

UpdateImagePropertiesRequest

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

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

string

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

imageProperties

object (ImageProperties)

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

fields

string (FieldMask format)

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

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

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

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

UpdateVideoPropertiesRequest

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

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

string

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

videoProperties

object (VideoProperties)

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

fields

string (FieldMask format)

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

יש לציין שדה אחד לפחות. הרמה הבסיסית (root) videoProperties היא משתמעת ואין לציין אותה. אפשר להשתמש ב-"*" אחד כקיצור דרך להצגת כל השדות.

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

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

UpdatePagePropertiesRequest

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

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

string

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

pageProperties

object (PageProperties)

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

fields

string (FieldMask format)

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

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

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

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

UpdateTableCellPropertiesRequest

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

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

TableRange

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

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

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

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

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

object (TableCellLocation)

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

rowSpan

integer

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

columnSpan

integer

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

UpdateLinePropertiesRequest

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

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

string

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

lineProperties

object (LineProperties)

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

fields

string (FieldMask format)

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

צריך לציין שדה אחד לפחות. הרמה הבסיסית (root) lineProperties היא משתמעת ואין לציין אותה. סינגל "*" יכולים לשמש כקיצורים לכל שדה.

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

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

CreateParagraphBulletsRequest

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

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

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

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

string

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

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

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

bulletPreset

enum (BulletGlyphPreset)

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

BulletGlyphPreset

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

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

  • ARROW : חץ שתואם לנקודת קוד בפורמט Unicode U+2794
  • ARROW3D : חץ עם צללית תלת-ממדית, התואם למיקום תו (code point) U+27a2 ב-Unicode
  • CHECKBOX : ריבוע חלול שתואם לנקודת קוד בפורמט Unicode U+274f
  • CIRCLE : עיגול חלול, התואם למיקום תו (code point) ב-Unicode‏ U+25cb
  • DIAMOND : ריבוע שחור מלא, שתואם למיקום תו (code point) U+25c6 ב-Unicode
  • DIAMONDX : יהלום עם 'x', שתואם לנקודת קוד של Unicode U+2756
  • HOLLOWDIAMOND : יהלום חלול, התואם למיקום תו (code point) U+25c7 ב-Unicode
  • DISC : עיגול מלא, שתואם לנקודת קוד בפורמט Unicode U+25cf
  • SQUARE : ריבוע מלא, שתואם לנקודת קוד של Unicode U+25a0
  • STAR : כוכב, התואם למיקום התו (code point) U+2605 ב-Unicode
  • 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 רמות הקינון הראשונות ברשימה, ואחריהן נקודות.

ReplaceAllShapesWithImageRequest

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

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

ייצוג ב-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.

ReplaceMethod

שיטת ההחלפה.

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

ImageReplaceMethod

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

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

DuplicateObjectRequest

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

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

ייצוג ב-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 תווים.

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

UpdateTextStyleRequest

מעדכנים את הסגנון של הטקסט ב-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".

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

ReplaceAllShapesWithSheetsChartRequest

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

הערה: כדי להחליף צורות בתרשים, צריך לפחות אחד מההיקפים spreadsheets.readonly,‏ spreadsheets,‏ drive.readonly או drive 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, או אם לא קיים בדף עם מזהה האובייקט הזה.

LinkingMode

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

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

DeleteParagraphBulletsRequest

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

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

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

string

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

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

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

UpdateParagraphStyleRequest

מעדכן את העיצוב לכל הפסקאות 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".

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

UpdateTableBorderPropertiesRequest

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

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

BorderPosition

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

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

UpdateTableColumnPropertiesRequest

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

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

יש לציין שדה אחד לפחות. הרמה הבסיסית (root) 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)

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

צריך לציין שדה אחד לפחות. הרמה הבסיסית (root) tableRowProperties היא משתמעת ואין לציין אותה. סינגל "*" יכולים לשמש כקיצורים לכל שדה.

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

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

MergeTableCellsRequest

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

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

string

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

tableRange

object (TableRange)

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

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

UnmergeTableCellsRequest

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

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

string

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

tableRange

object (TableRange)

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

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

GroupObjectsRequest

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

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

string

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

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

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

childrenObjectIds[]

string

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

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

UngroupObjectsRequest

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

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

string

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

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

UpdatePageElementAltTextRequest

מעדכן את הכותרת ו/או התיאור של הטקסט החלופי page element

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

string

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

title

string

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

description

string

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

ReplaceImageRequest

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

החלפת תמונה מסירה חלק מה-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 שליחת רכיבי הדף לחלק האחורי של הדף.

UpdateLineCategoryRequest

מעדכן את הקטגוריה של line

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

string

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

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

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

lineCategory

enum (LineCategory)

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

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

RerouteLineRequest

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

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

string

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

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