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

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

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

slideLayoutReference

object (LayoutReference)

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

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

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

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

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

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

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

טיפוסים בני מנייה (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 (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,
  "searchByRegex": boolean
}
שדות
text

string

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

matchCase

boolean

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

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

boolean

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

  • 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 במטריצה החדשה.

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)

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

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

המאפיין