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)

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

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

אם 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)

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

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)

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

סוג הטווח.

סוג

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

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

הערה: כדי לרענן תרשימים צריך לפחות היקפי הרשאות OAuth אחת מסוג Sheets.readonly, גיליונות אלקטרוניים, Drive.readonly או 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)

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

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

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

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

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

textRange

object (Range)

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

bulletPreset

enum (BulletGlyphPreset)

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

BulletGlyphPreset

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

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

  • 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 רמות הקינון הראשונות ברשימה, ואחריהן נקודות.

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)

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

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

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

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

ReplaceAllShapesWithSheetsChartRequest

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

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

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

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

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)

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

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

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

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

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

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

UnmergeTableCellsRequest

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

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

string

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

tableRange

object (TableRange)

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

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

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