בקשה
סוג אחד של עדכון שחל על מצגת.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד
kind . סוג העדכון. חובה למלא שדה אחד בדיוק.
kind
יכול להיות רק אחד מהבאים:
|
|
createSlide
|
יוצר שקף חדש. |
createShape
|
יוצר צורה חדשה. |
createTable
|
יצירת טבלה חדשה. |
insertText
|
הוספת טקסט לצורה או לתא בטבלה. |
insertTableRows
|
הוספת שורות לטבלה. |
insertTableColumns
|
הוספת עמודות לטבלה. |
deleteTableRow
|
מחיקת שורה מהטבלה. |
deleteTableColumn
|
מחיקת עמודה מהטבלה. |
replaceAllText
|
החלפת כל המופעים של טקסט מסוים. |
deleteObject
|
מחיקת דף או רכיב דף מהמצגת. |
updatePageElementTransform
|
עדכון הטרנספורמציה של רכיב דף. |
updateSlidesPosition
|
עדכון המיקום של קבוצת שקפים במצגת. |
deleteText
|
מחיקת טקסט מצורה או מתא בטבלה. |
createImage
|
יצירת תמונה. |
createVideo
|
יצירת סרטון. |
createSheetsChart
|
יצירת תרשים הטמעת של Google Sheets. |
createLine
|
יוצר קו. |
refreshSheetsChart
|
מרענן תרשים של Google Sheets. |
updateShapeProperties
|
עדכון המאפיינים של |
updateImageProperties
|
מתבצע עדכון של המאפיינים של |
updateVideoProperties
|
עדכון המאפיינים של |
updatePageProperties
|
עדכון המאפיינים של |
updateTableCellProperties
|
עדכון המאפיינים של |
updateLineProperties
|
עדכון המאפיינים של |
createParagraphBullets
|
יוצרת תבליטים לפסקאות. |
replaceAllShapesWithImage
|
החלפת כל הצורות שתואמות לקריטריונים מסוימים בתמונה. |
duplicateObject
|
משכפל שקף או רכיב דף. |
updateTextStyle
|
|
replaceAllShapesWithSheetsChart
|
החלפת כל הצורות שתואמות לקריטריונים מסוימים בתרשים Google Sheets. |
deleteParagraphBullets
|
מחיקת תבליטים מפסקאות. |
updateParagraphStyle
|
|
updateTableBorderProperties
|
עדכון המאפיינים של גבולות הטבלה ב |
updateTableColumnProperties
|
עדכון המאפיינים בעמודה |
updateTableRowProperties
|
עדכון המאפיינים של שורה |
mergeTableCells
|
מיזוג תאים בתוך
|
unmergeTableCells
|
ביטול המיזוג של תאים ב- |
groupObjects
|
אובייקטים מקובצים, כמו רכיבי דף. |
ungroupObjects
|
ביטול הקיבוץ של אובייקטים, כמו
|
updatePageElementAltText
|
עדכון השם או התיאור של הטקסט החלופי ב- |
replaceImage
|
מחליפה תמונה קיימת בתמונה חדשה. |
updateSlideProperties
|
עדכון המאפיינים של שקף |
updatePageElementsZOrder
|
עדכון של סדר ה-Z של
|
updateLineCategory
|
עדכון הקטגוריה של |
rerouteLine
|
מנתב מחדש
|
CreateSlideRequest
יוצר שקף.
ייצוג JSON |
---|
{ "objectId": string, "insertionIndex": integer, "slideLayoutReference": { object ( |
שדות | |
---|---|
objectId
|
מזהה אובייקט שסופק על ידי המשתמש.
אם מציינים מזהה, הוא צריך להיות ייחודי בין כל הדפים ורכיבי הדפים במצגת. המזהה חייב להתחיל בתו אלפאנומרי או בקו תחתון (תואם לביטוי רגולרי
אם לא תציינו מזהה, ייווצר מזהה ייחודי. |
insertionIndex
|
אינדקס אופציונלי מבוסס אפס שמציין היכן להוסיף את השקפים. אם לא מציינים אינדקס, השקף נוצר בסוף. |
slideLayoutReference
|
פריסת הפריסה של השקף שרוצים להוסיף, מבוססת על המאסטר הנוכחי, שהוא אחד מהבאים:
אם ה-LayoutReference לא נמצא במאסטר הנוכחי, מחזירה שגיאת 400 של בקשה שגויה.
אם לא מציינים קובץ עזר לפריסה, השקף ישתמש בפריסת |
placeholderIdMappings[]
|
רשימה אופציונלית של מיפויים של מזהי אובייקטים מ- |
מדריך לפריסה
הפניה לפריסת שקפים. אלה עשויים להתייחס ל:
- פריסה מוגדרת מראש
- אחת מהפריסות במצגת.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד
kind . הסוג של LayoutReference.
kind
יכול להיות רק אחד מהבאים:
|
|
predefinedLayout
|
פריסה מוגדרת מראש. |
layoutId
|
מזהה פריסה: מזהה האובייקט של אחת מהפריסות במצגת. |
פריסה מוגדרת מראש
סוגי פריסה מוגדרים מראש. בדרך כלל אלו פריסות הנמצאות במצגות. עם זאת, אין ערובה לכך שהפריסות האלה קיימות במאסטר הנוכחי מפני שהן נמחקו או שהן לא חלק מהעיצוב המשומש. בנוסף, ייתכן שה-placeholders בכל פריסה השתנו.
טיפוסים בני מנייה (enum) | |
---|---|
PREDEFINED_LAYOUT_UNSPECIFIED
|
פריסה לא מוגדרת |
BLANK
|
פריסה ריקה, ללא placeholders. |
CAPTION_ONLY
|
פריסה עם כיתוב למטה. |
TITLE
|
פריסה עם כותרת וכותרת משנה. |
TITLE_AND_BODY
|
פריסה עם כותרת וטקסט. |
TITLE_AND_TWO_COLUMNS
|
פריסה עם כותרת ושתי עמודות. |
TITLE_ONLY
|
פריסה עם כותרת בלבד. |
SECTION_HEADER
|
פריסה עם כותרת הקטע. |
SECTION_TITLE_AND_DESCRIPTION
|
פריסה עם כותרת וכותרת משנה בצד אחד ותיאור בצד השני. |
ONE_COLUMN_TEXT
|
פריסה עם כותרת אחת וגוף אחד, מאורגנת בעמודה אחת. |
MAIN_POINT
|
פריסה עם נקודה ראשית. |
BIG_NUMBER
|
פריסה עם כותרת גדולה של מספר. |
LayoutPlaceholderIdמיפוי
מיפוי המזהה שצוין על ידי משתמש עבור placeholder שייווצר בשקף מפריסה שצוינה.
ייצוג JSON |
---|
{ "objectId": string, // Union field |
שדות | |
---|---|
objectId
|
מזהה אובייקט שסופק על ידי המשתמש עבור ה-placeholder שצוין למעלה, שאותו יש ליצור בשקף.
אם מציינים מזהה, הוא צריך להיות ייחודי בין כל הדפים ורכיבי הדפים במצגת. המזהה חייב להתחיל בתו אלפאנומרי או בקו תחתון (תואם לביטוי רגולרי
אם לא תציינו מזהה, ייווצר מזהה ייחודי. |
שדה איחוד
kind . הסוג הזה כדי לזהות placeholder בפריסה.
kind
יכול להיות רק אחד מהבאים:
|
|
layoutPlaceholder
|
ה-placeholder בפריסה שתוחל על שקף. רק
|
layoutPlaceholderObjectId
|
מזהה האובייקט של ה-placeholder בפריסה שתוחל על שקף. |
CreateצורRequest
יוצר צורה חדשה.
ייצוג JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
שדות | |
---|---|
objectId
|
מזהה אובייקט שסופק על ידי המשתמש.
אם מציינים מזהה, הוא צריך להיות ייחודי בין כל הדפים ורכיבי הדפים במצגת. המזהה חייב להתחיל בתו אלפאנומרי או בקו תחתון (תואם לביטוי רגולרי
|
elementProperties
|
מאפייני הרכיב של הצורה. |
shapeType
|
סוג הצורה. |
מאפייני דף
מאפיינים נפוצים של רכיב דף.
הערה: כשיוצרים PageElement
, ה-API עשוי לשנות את הערכים של size
ושל transform
, אבל הגודל החזותי לא ישתנה.
ייצוג JSON |
---|
{ "pageObjectId": string, "size": { object ( |
שדות | |
---|---|
pageObjectId
|
מזהה האובייקט של הדף שבו הרכיב נמצא. |
size
|
גודל הרכיב. |
transform
|
הטרנספורמציה של הרכיב. |
CreateTableRequest
יצירת טבלה חדשה.
ייצוג JSON |
---|
{
"objectId": string,
"elementProperties": {
object (
|
שדות | |
---|---|
objectId
|
מזהה אובייקט שסופק על ידי המשתמש.
אם מציינים מזהה, הוא צריך להיות ייחודי בין כל הדפים ורכיבי הדפים במצגת. המזהה חייב להתחיל בתו אלפאנומרי או בקו תחתון (תואם לביטוי רגולרי
אם לא תציינו מזהה, ייווצר מזהה ייחודי. |
elementProperties
|
מאפייני הרכיב בטבלה. הטבלה תיווצר בגודל המינימלי, בכפוף לגודל מינימלי. אם לא סופק גודל, הגודל של הטבלה ישתנה באופן אוטומטי. טרנספורמציות טבלה חייבות להיות בקנה מידה של 1 וללא רכיבי חיתוך. אם לא תספק טרנספורמציה, הטבלה תתמקד במרכז הדף. |
rows
|
מספר השורות בטבלה. |
columns
|
מספר העמודות בטבלה. |
InsertTextRequest
הוספת טקסט לצורה או לתא בטבלה.
ייצוג JSON |
---|
{
"objectId": string,
"cellLocation": {
object (
|
שדות | |
---|---|
objectId
|
מזהה האובייקט של הצורה או הטבלה שבהן הטקסט יוכנס. |
cellLocation
|
המיקום האופציונלי של תא בטבלה אם רוצים להוסיף את הטקסט לתא. אם השדה קיים, ה-ObjectId חייב להתייחס לטבלה. |
text
|
הטקסט להוספה.
הוספה של תו חדש של שורה תוביל ליצירת
סגנונות טקסט עבור טקסט שנוסף ייקבעו באופן אוטומטי, תוך שימור כללי הסגנון של הטקסט הסמוך. ברוב המקרים, הטקסט יתווסף
ל- כמה תווי בקרה (U+0000-U+0008, U+000C-U+001F) ותווים מאזור השימוש הפרטי במטוס הרב-תרבותי של Unicode (U+E000-U+F8FF) יוסרו מהטקסט שנוסף. |
insertionIndex
|
האינדקס שבו יתווסף הטקסט, ביחידות קוד Unicode, על סמך
האינדקס מבוסס על אפס והוא מחושב מתחילת המחרוזת. ניתן להתאים את האינדקס כדי למנוע הוספות באשכולות Unicode של Unicode. במקרים כאלה, הטקסט יתווסף מיד אחרי אשכול התרשימים. |
InsertTableRowsRequest
הוספת שורות לטבלה.
ייצוג JSON |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
שדות | |
---|---|
tableObjectId
|
הטבלה שאליה יש להוסיף שורות. |
cellLocation
|
המיקום בתא שבו נמצאת טבלת ההפניות, שבה יתווספו השורות. שורה חדשה תתווסף מעל (או מתחת) לשורה שבה נמצא תא ההפניה. אם התא ההפניה הוא תא שמוזג, תוכנס שורה חדשה מעל (או מתחת) לתא שמוזג. |
insertBelow
|
האם להוסיף שורות חדשות מתחת למיקום של ההפניה?
|
number
|
מספר השורות להוספה. 20 בקשות לכל היותר. |
InsertTableColumnRequest
הוספת עמודות לטבלה.
הגודל של עמודות אחרות בטבלה ישתנה כך שיתאים לעמודה החדשה.
ייצוג JSON |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
שדות | |
---|---|
tableObjectId
|
הטבלה שאליה יועברו העמודות. |
cellLocation
|
המיקום בתא שבו נמצאת טבלת ההפניות, שממנו יתווספו העמודות. עמודה חדשה תתווסף משמאל (או לימין) של העמודה שבה נמצא תא ההפניה. אם התא המפנה הוא תא שהוכנס, עמודה חדשה תתווסף משמאל (או מימין) של התא שמוזג. |
insertRight
|
האם להוסיף עמודות חדשות מימין למיקום של תא ההפניה.
|
number
|
מספר העמודות להוספה. 20 בקשות לכל היותר. |
DeleteTableRowRequest
מחיקת שורה מהטבלה.
ייצוג JSON |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
שדות | |
---|---|
tableObjectId
|
הטבלה שממנה יש למחוק שורות. |
cellLocation
|
מיקום התא של טבלת ההפניות, שממנו תימחק שורה. השורה שבה התא הזה תימחק. אם זהו תא שמוזג, מספר שורות יימחקו. אם לא יימחקו שורות בטבלה אחרי המחיקה הזו, כל הטבלה תימחק. |
DeleteTableColumnRequest
מחיקת עמודה מהטבלה.
ייצוג JSON |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
שדות | |
---|---|
tableObjectId
|
הטבלה שממנה יש למחוק את העמודות. |
cellLocation
|
המיקום של התא בטבלת ההפניה, שממנו תימחק עמודה. העמודה הזו תחול. אם זהו תא שמוזג, מספר עמודות יימחקו. אם לא יימחקו עמודות בטבלה לאחר המחיקה, כל הטבלה תימחק. |
החלפת AllTextRequest
החלפת כל המופעים של טקסט שתואם לקריטריונים ב-
replace text
.
ייצוג JSON |
---|
{ "replaceText": string, "pageObjectIds": [ string ], // Union field |
שדות | |
---|---|
replaceText
|
הטקסט שיחליף את הטקסט התואם. |
pageObjectIds[]
|
אם לא ריק, מגביל את ההתאמות לרכיבי דף רק בדפים הנתונים.
מחזירה שגיאת 400 של בקשה שגויה אם קיים מזהה אובייקט דף של
|
שדה איחוד
criteria . הקריטריונים שמשמשים להתאמה של טקסט להחלפה.
criteria
יכול להיות רק אחד מהבאים:
|
|
containsText
|
חיפוש טקסט בצורה שתואמת למחרוזת המשנה הזו. |
מחרוזות משנה של התאמה
קריטריון שתואם למחרוזת טקסט ספציפית בצורה או בטבלה.
ייצוג JSON |
---|
{ "text": string, "matchCase": boolean } |
שדות | |
---|---|
text
|
הטקסט שיש לחפש בצורה או בטבלה. |
matchCase
|
מציין אם החיפוש צריך להתייחס לאותיות רישיות:
|
DeleteObjectRequest
מחיקת אובייקט מהמצגת pages
או page elements
מהמצגת.
ייצוג JSON |
---|
{ "objectId": string } |
שדות | |
---|---|
objectId
|
מזהה האובייקט של הדף או רכיב הדף למחיקה.
אם אחרי פעולת מחיקה,
אם ה-placeholder נמחק בפריסה, כל ה-placeholders הריקים הריקים יימחקו. |
UpdatePageElementTransformRequest
עדכון הטרנספורמציה של רכיב דף.
עדכון הטרנספורמציה של קבוצה ישנה את הטרנספורמציה המוחלטת של רכיבי הדף בקבוצה, מה שיכול לשנות את המראה החזותי שלהם. לפרטים נוספים אפשר לעיין במסמכי התיעוד של
PageElement.transform
.
ייצוג JSON |
---|
{ "objectId": string, "transform": { object ( |
שדות | |
---|---|
objectId
|
מזהה האובייקט של רכיב הדף שיש לעדכן. |
transform
|
מטריצת הטרנספורמציה של הקלט המשמשת לעדכון רכיב הדף. |
applyMode
|
מצב ההחלה של עדכון הטרנספורמציה. |
החלת מצב
מצבי היישום של עדכון הטרנספורמציה.
טיפוסים בני מנייה (enum) | |
---|---|
APPLY_MODE_UNSPECIFIED
|
מצב לא מוגדר. |
RELATIVE
|
החלת מטריצה חדשה של AffineTransform למטריצה הקיימת. היא תחליף את המטריצה הקיימת בשרשור שמתקבל. |
ABSOLUTE
|
מחליפה את המטריצה הקיימת ב-AffineTransform במטריצה החדשה. |
עדכון SlidesSlidesRequest
עדכון המיקום של שקפים במצגת.
ייצוג JSON |
---|
{ "slideObjectIds": [ string ], "insertionIndex": integer } |
שדות | |
---|---|
slideObjectIds[]
|
מזהי השקפים במצגת שיש להעביר. השקפים ברשימה הזו חייבים להיות בסדר קיים של מצגות, ללא כפילויות. |
insertionIndex
|
האינדקס שבו יש להוסיף את השקפים בהתאם לסידור השקפים לפני תחילת ההעברה. חייב להיות בין אפס למספר השקפים במצגת, כולל. |
DeleteTextRequest
מחיקת טקסט מצורה או מתא בטבלה.
ייצוג JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
שדות | |
---|---|
objectId
|
מזהה האובייקט של הצורה או הטבלה שמהם הטקסט יימחק. |
cellLocation
|
המיקום האופציונלי של תא הטבלה אם הטקסט יימחק מתא הטבלה. אם השדה קיים, ה-ObjectId חייב להתייחס לטבלה. |
textRange
|
טווח הטקסט למחיקה, על סמך
בסוף הטקסט של צורה או תא בטבלה תמיד יש תו מרומז חדש שלא ניתן למחוק.
מחיקת טקסט שחוצה גבול של פסקה עשויה לגרום לשינויים בסגנונות וברשימות של פסקאות בעת מיזוג שתי הפסקאות. טווחים שכוללים רק יחידת קוד אחת של צמד פונדקאות הורחבו כך שיכללו את שתי יחידות הקוד. |
טווח
המדיניות מציינת טווח רציף של אוסף שנוסף לאינדקס, כמו תווים בטקסט.
ייצוג JSON |
---|
{
"startIndex": integer,
"endIndex": integer,
"type": enum (
|
שדות | |
---|---|
startIndex
|
אינדקס אופציונלי מבוסס-אפס מתחילת תחילת האוסף. חובה בטווחים |
endIndex
|
אינדקס אופציונלי מבוסס-אפס בסוף האוסף. חובה עבור
|
type
|
סוג הטווח. |
Type
סוגי הטווחים.
טיפוסים בני מנייה (enum) | |
---|---|
RANGE_TYPE_UNSPECIFIED
|
סוג טווח לא צוין. אין להשתמש בערך הזה. |
FIXED_RANGE
|
טווח קבוע. יש לציין את
startIndex
וגם את
endIndex .
|
FROM_START_INDEX
|
מתחיל את הטווח ב-startIndex וממשיך עד סוף האוסף. לא ניתן לציין את
endIndex .
|
ALL
|
מגדיר את הטווח כאורך המלא של האוסף. אין לציין את
startIndex
וגם את
endIndex .
|
CreateImageRequest
יצירת תמונה.
ייצוג JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
שדות | |
---|---|
objectId
|
מזהה אובייקט שסופק על ידי המשתמש.
אם מציינים מזהה, הוא צריך להיות ייחודי בין כל הדפים ורכיבי הדפים במצגת. המזהה חייב להתחיל בתו אלפאנומרי או בקו תחתון (תואם לביטוי רגולרי
אם לא תציינו מזהה, ייווצר מזהה ייחודי. |
elementProperties
|
מאפייני הרכיב של התמונה. כשיחס הגובה-רוחב של התמונה שצוינה לא תואם ליחס הגובה-רוחב של התמונה, התמונה מוקטנת וממורכזת ביחס לגודל כדי לשמור על יחס הגובה-רוחב. הטרנספורמציה שסופקה מוחלת לאחר הפעולה הזו.
המאפיין
המאפיין
|
שדה איחוד
image_source . סוג מקור התמונה.
image_source
יכול להיות רק אחד מהבאים:
|
|
url
|
כתובת ה-URL של התמונה. התמונה מאוחזרת פעם אחת בזמן ההוספה, ועותק נשמר לתצוגה בתוך המצגת. התמונות צריכות להיות קטנות מ-50MB ובגודל של עד 25 מגה פיקסל. הן צריכות להיות בפורמט PNG, JPEG או GIF.
כתובת ה-URL שצוינה חייבת להיות נגישה לכולם, ואורכה יכול להיות 2KB. כתובת ה-URL נשמרת עם התמונה, ונחשפת דרך השדה |
בקשת VideoVideo
יצירת סרטון.
הערה: כשיוצרים סרטון מ-Google Drive, צריך לוודא שהאפליקציה המבקשת כוללת לפחות אחד מהיקפי ההרשאות של Drive, drive.readonly או drive.file מסוג OAuth.
ייצוג JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
שדות | |
---|---|
objectId
|
מזהה אובייקט שסופק על ידי המשתמש.
אם מציינים מזהה, הוא צריך להיות ייחודי בין כל הדפים ורכיבי הדפים במצגת. המזהה חייב להתחיל בתו אלפאנומרי או בקו תחתון (תואם לביטוי רגולרי
אם לא תציינו מזהה, ייווצר מזהה ייחודי. |
elementProperties
|
מאפייני הרכיב של הסרטון.
המאפיין
המאפיין
|
source
|
מקור הסרטון. |
id
|
המזהה הייחודי של מקור הסרטון. למשל, בסרטון של YouTube https://www.youtube.com/watch?v=7U3axjORYZ0, המזהה הוא 7U3axjORYZ0. בסרטון ב-Google Drive https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q המזהה הוא 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q. כדי לגשת לקובץ וידאו ב-Google Drive, ייתכן שתצטרכו להוסיף מפתח משאב לכותרת ה-HTTP של קבוצת משנה של קבצים ישנים. מידע נוסף זמין במאמר גישה לקבצים ששותפו באמצעות קישורים באמצעות מפתחות משאבים. |
CreateSheetsChartRequest
יצירת תרשים הטמעת של Google Sheets.
הערה: ליצירת תרשים נדרש לפחות אחד מההיקפים של spreadsheets.readonly, sheets , drive.readonly, drive.file או Drive של היקפי OAuth.
ייצוג JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
שדות | |
---|---|
objectId
|
מזהה אובייקט שסופק על ידי המשתמש. אם צוין, המזהה חייב להיות ייחודי בין כל הדפים ורכיבי הדפים במצגת. המזהה צריך להתחיל בתו של מילה [a-zA-Z0-9_] ואחריו כל אחד מהתווים הבאים [a-zA-Z0-9_-:]. האורך של המזהה לא יכול להיות קצר מ-5 או גדול מ-50. אם השדה ריק, המערכת תיצור מזהה ייחודי. |
elementProperties
|
מאפייני הרכיב בתרשים. כשיחס הגובה-רוחב של הגודל שצוין אינו תואם ליחס הגובה-רוחב של התרשים, התרשים מוקטן וממורכז ביחס לגודל כדי לשמור על יחס הגובה-רוחב. הטרנספורמציה שסופקה מוחלת לאחר הפעולה הזו. |
spreadsheetId
|
המזהה של הגיליון האלקטרוני ב-Google Sheets שמכיל את התרשים. יכול להיות שתצטרכו להוסיף מפתח משאב לכותרת ה-HTTP לקבוצת משנה של קבצים ישנים. מידע נוסף זמין במאמר גישה לקבצים ששותפו באמצעות קישורים באמצעות מפתחות משאבים. |
chartId
|
המזהה של התרשים הספציפי בגיליון האלקטרוני של Google Sheets. |
linkingMode
|
המצב שבו התרשים מקושר לגיליון האלקטרוני המקורי. אם לא צוין אחרת, התרשים יהיה תמונה שאינה מקושרת. |
מצב קישור
המצב שבו התרשים מקושר לגיליון האלקטרוני המקורי.
טיפוסים בני מנייה (enum) | |
---|---|
NOT_LINKED_IMAGE
|
התרשים לא משויך לגיליון האלקטרוני המקורי ולא ניתן לעדכן אותו. תרשים שלא מקושר אליו יתווסף כתמונה. |
LINKED
|
קישור התרשים מאפשר את עדכוןו, ושותפי עריכה אחרים יראו קישור לגיליון האלקטרוני. |
CreateLineRequest
יוצר קו.
ייצוג JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
שדות | |
---|---|
objectId
|
מזהה אובייקט שסופק על ידי המשתמש.
אם מציינים מזהה, הוא צריך להיות ייחודי בין כל הדפים ורכיבי הדפים במצגת. המזהה חייב להתחיל בתו אלפאנומרי או בקו תחתון (תואם לביטוי רגולרי
אם לא תציינו מזהה, ייווצר מזהה ייחודי. |
elementProperties
|
מאפייני הרכיב שבשורה. |
lineCategory
|
הקטגוריה של הקו שצריך ליצור.
הוצאה משימוש
: במקומה יש להשתמש באפשרות
התוכן המדויק
אם מציינים גם |
category
|
הקטגוריה של הקו שצריך ליצור.
התוכן המדויק
אם מציינים גם
אם לא מציינים ערך עבור
אם לא מציינים שום דבר, נעשה שימוש ב-
|
קטגוריה
הקטגוריות של השורות.
טיפוסים בני מנייה (enum) | |
---|---|
STRAIGHT
|
מחברים ישרים, כולל מחבר ישר 1. זוהי קטגוריית ברירת המחדל, אם לא צוינה קטגוריה. |
BENT
|
מחברי כיפוף, כולל מחבר מכופף 2 עד 5. |
CURVED
|
מחברים מתעקלים, כולל מחבר מעוקל 2 עד 5. |
רענון SheetsChartRequest
מרענן תרשים מוטמע של Google Sheets על ידי החלפתו בגרסה האחרונה של התרשים מ-Google Sheets.
הערה: רענון התרשימים מצריך לפחות אחת מהגיליונות האלקטרוניים.קריאה בלבד, גיליונות אלקטרוניים, drive.readonly, או הנעת היקפי OAuth.
ייצוג JSON |
---|
{ "objectId": string } |
שדות | |
---|---|
objectId
|
מזהה האובייקט של התרשים לרענון. |
עדכון DesignFormsRequest
יש לעדכן את המאפיינים של
Shape
.
ייצוג JSON |
---|
{
"objectId": string,
"shapeProperties": {
object (
|
שדות | |
---|---|
objectId
|
מזהה האובייקט של הצורה שעליה מתבצעים העדכונים. |
shapeProperties
|
מאפייני הצורה שצריך לעדכן. |
fields
|
השדות שצריך לעדכן.
יש לציין לפחות שדה אחד. השורש
לדוגמה, כדי לעדכן את צבע המילוי המלא של רקע הצורה, מגדירים את הערך כדי לאפס נכס לערך ברירת המחדל, צריך לכלול את שם השדה שלו במסכה של השדה, אבל להשאיר את השדה עצמו לא מוגדר. |
עדכון ImageImageRequest
יש לעדכן את המאפיינים של
Image
.
ייצוג JSON |
---|
{
"objectId": string,
"imageProperties": {
object (
|
שדות | |
---|---|
objectId
|
מזהה האובייקט של התמונה, שאליה חלים העדכונים. |
imageProperties
|
מאפייני התמונה שצריך לעדכן. |
fields
|
השדות שצריך לעדכן.
יש לציין לפחות שדה אחד. השורש
לדוגמה, כדי לעדכן את צבע המתאר של התמונה, מגדירים את הערך כדי לאפס נכס לערך ברירת המחדל, צריך לכלול את שם השדה שלו במסכה של השדה, אבל להשאיר את השדה עצמו לא מוגדר. |
עדכון VideoUpdateRequest
יש לעדכן את המאפיינים של
Video
.
ייצוג JSON |
---|
{
"objectId": string,
"videoProperties": {
object (
|
שדות | |
---|---|
objectId
|
מזהה האובייקט של הסרטון שעליו חלים העדכונים. |
videoProperties
|
מאפייני הסרטון לעדכון. |
fields
|
השדות שצריך לעדכן.
יש לציין לפחות שדה אחד. השורש
לדוגמה, כדי לעדכן את צבע מתאר הסרטון, מגדירים את הערך כדי לאפס נכס לערך ברירת המחדל, צריך לכלול את שם השדה שלו במסכה של השדה, אבל להשאיר את השדה עצמו לא מוגדר. |
עדכון דף המאפיינים
עדכון המאפיינים של Page
.
ייצוג JSON |
---|
{
"objectId": string,
"pageProperties": {
object (
|
שדות | |
---|---|
objectId
|
מזהה האובייקט של הדף שעליו חל העדכון. |
pageProperties
|
מאפייני הדף שיש לעדכן. |
fields
|
השדות שצריך לעדכן.
יש לציין לפחות שדה אחד. השורש
לדוגמה, כדי לעדכן את צבע המילוי המלא של רקע הדף, מגדירים את הערך כדי לאפס נכס לערך ברירת המחדל, צריך לכלול את שם השדה שלו במסכה של השדה, אבל להשאיר את השדה עצמו לא מוגדר. |
עדכוןTTCCllllPropertiesRequest
יש לעדכן את המאפיינים של
TableCell
.
ייצוג JSON |
---|
{ "objectId": string, "tableRange": { object ( |
שדות | |
---|---|
objectId
|
מזהה האובייקט של הטבלה. |
tableRange
|
טווח הטבלאות שמייצג את קבוצת המשנה של הטבלה שעליה מוחלים העדכונים. אם לא מציינים טווח בטבלה, העדכונים יחולו על כל הטבלה. |
tableCellProperties
|
המאפיינים של תא הטבלה שיש לעדכן. |
fields
|
השדות שצריך לעדכן.
יש לציין לפחות שדה אחד. השורש
לדוגמה, כדי לעדכן את צבע המילוי של רקע התא בטבלה, מגדירים את הערך כדי לאפס נכס לערך ברירת המחדל, צריך לכלול את שם השדה שלו במסכה של השדה, אבל להשאיר את השדה עצמו לא מוגדר. |
טווח טבלאות
טווח של טבלה מייצג הפניה לקבוצת משנה של טבלה.
חשוב לציין שהתאים שצוינו בטווח טבלאות לא בהכרח יוצרים מלבן. לדוגמה, נניח שיש לנו טבלה בגודל 3 x 3, שבה כל התאים של השורה האחרונה ממוזגים יחד. הטבלה נראית כך:
[ ][ ][ ]
[ ][ ][ ]
[ ]
טווח בטבלה עם מיקום = (0, 0), שורה span = 3 ועמודה עמודה = 2 מציין את התאים הבאים:
[ x ][ x ][ ]
[ x ][ x ][ ]
[ x x x ]
ייצוג JSON |
---|
{
"location": {
object (
|
שדות | |
---|---|
location
|
המיקום ההתחלתי של טווח הטבלאות. |
rowSpan
|
אורך השורה של טווח הטבלה. |
columnSpan
|
טווח העמודות של טווח הטבלה. |
עדכון LineLineProperties
עדכון המאפיינים של Line
.
ייצוג JSON |
---|
{
"objectId": string,
"lineProperties": {
object (
|
שדות | |
---|---|
objectId
|
מזהה האובייקט של השורה שעליה חל העדכון. |
lineProperties
|
מאפייני הקו שיש לעדכן. |
fields
|
השדות שצריך לעדכן.
יש לציין לפחות שדה אחד. השורש
לדוגמה, כדי לעדכן את צבע המילוי המלא של הקו, מגדירים את הערך
כדי לאפס נכס לערך ברירת המחדל, צריך לכלול את שם השדה שלו במסכה של השדה, אבל להשאיר את השדה עצמו לא מוגדר. |
CreateParagraphbulletsRequest
יוצרת תבליטים לכל הפסקאות שחופפות לטווח הנתון של אינדקס הטקסט.
רמת הסידור של כל פסקה תיקבע על ידי ספירת הכרטיסיות המובילות לפני כל פסקה. כדי להימנע ממרווח יתר בין התבליט לפסקה המתאימה, הבקשה הזו תוסר. הפעולה הזו עשויה לשנות את האינדקסים של חלקים בטקסט.
אם הפיסקה מייד לפני העדכון של הפסקאות נמצאת ברשימה עם הגדרה קבועה מראש תואמת, הפסקאות שעודכנו יתווספו לרשימה הקודמת.
ייצוג JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
שדות | |
---|---|
objectId
|
מזהה האובייקט של הצורה או הטבלה שמכילים את הטקסט להוספת תבליטים. |
cellLocation
|
המיקום האופציונלי של תא הטבלה אם הטקסט שיש לשנות נמצא בתא בטבלה. אם השדה קיים, ה-ObjectId חייב להתייחס לטבלה. |
textRange
|
טווח הטקסט שעליו יש להחיל את הערכים הקבועים מראש, על סמך
|
bulletPreset
|
סוגי הגליפים של התבליטים שבהם יש להשתמש. ברירת המחדל היא
|
תבליט Greset
תבניות מוגדרות מראש של גליפים של תבליטים ברשימות ברשימות.
בתבניות האלה נעשה שימוש בתבליטים מהסוגים הבאים:
-
ARROW
: חץ, שתואם לנקודת קוד Unicode U+2794 -
ARROW3D
: חץ עם הצללה תלת-ממדית, בהתאם לנקודת הקוד Unicode U+27a2 -
CHECKBOX
: ריבוע ריק, שתואם לנקודת קוד Unicode U+274f -
CIRCLE
: עיגול חלול שתואם לנקודת הקוד Unicode U+25cb -
DIAMOND
: יהלום מלא, שתואם לנקודת קוד Unicode U+25c6 -
DIAMONDX
: יהלום עם 'x', תואם לנקודת קוד Unicode U+2756 -
HOLLOWDIAMOND
: יהלום חלול, שתואם לנקודת קוד Unicode U+25c7 -
DISC
: עיגול יציב, התואם לנקודת קוד Unicode U+25cf -
SQUARE
: ריבוע מלא, שתואם לנקודת הקוד של Unicode U+25a0 -
STAR
: כוכב, שתואם לנקודת קוד Unicode U+2605 -
ALPHA
: אות קטנה, כמו 'a', 'b' או 'c'. -
UPPERALPHA
: אות גדולה, כמו 'A', 'B' או 'C'. -
DIGIT
: מספר, כמו '1', '2' או '3'. -
ZERODIGIT
: מספר הכולל ספרות בודדות עם קידומת אפס, למשל '01', '02' או '03'. מספרים בעלי יותר מספרה אחת אינם קידומת של אפס. -
ROMAN
: ספרה רומית קטנה, כמו 'i', 'ii' או 'iii'. -
UPPERROMAN
: ספרה רומית גדולה, כמו 'I', 'II' או 'III'. -
LEFTTRIANGLE
: משולש שמצביע שמאלה, בהתאם לנקודה בקוד Unicode U+25c4
טיפוסים בני מנייה (enum) | |
---|---|
BULLET_DISC_CIRCLE_SQUARE
|
רשימת תבליטים עם
תבליט תבליטים מסוג
DISC ,
CIRCLE
ו-SQUARE
ל-3 רמות הסידור הראשונות של הרשימות.
|
BULLET_DIAMONDX_ARROW3D_SQUARE
|
רשימת תבליטים עם
תבליט תבליטים מסוג
DIAMONDX ,
ARROW3D
ו-SQUARE
ל-3 רמות הסידור הראשונות של הרשימות.
|
BULLET_CHECKBOX
|
רשימת תבליטים עם
CHECKBOX
גליפים של תבליטים לכל הרמות של קינון הרשימות.
|
BULLET_ARROW_DIAMOND_DISC
|
רשימת תבליטים עם
תבליט תבליטים מסוג
ARROW ,
DIAMOND
ו-DISC
ל-3 רמות הסידור הראשונות של הרשימות.
|
BULLET_STAR_CIRCLE_SQUARE
|
רשימת תבליטים עם
תבליט תבליטים מסוג
STAR ,
CIRCLE
ו-SQUARE
ל-3 רמות הסידור הראשונות של הרשימות.
|
BULLET_ARROW3D_CIRCLE_SQUARE
|
רשימת תבליטים עם
תבליט תבליטים מסוג
ARROW3D ,
CIRCLE
ו-SQUARE
ל-3 רמות הסידור הראשונות של הרשימות.
|
BULLET_LEFTTRIANGLE_DIAMOND_DISC
|
רשימת תבליטים עם
תבליט תבליטים מסוג
LEFTTRIANGLE ,
DIAMOND
ו-DISC
ל-3 רמות הסידור הראשונות של הרשימות.
|
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE
|
רשימת תבליטים עם
תבליט תבליטים מסוג
DIAMONDX ,
HOLLOWDIAMOND
ו-SQUARE
ל-3 רמות הסידור הראשונות של הרשימות.
|
BULLET_DIAMOND_CIRCLE_SQUARE
|
רשימת תבליטים עם
תבליט תבליטים מסוג
DIAMOND ,
CIRCLE
ו-SQUARE
ל-3 רמות הסידור הראשונות של הרשימות.
|
NUMBERED_DIGIT_ALPHA_ROMAN
|
רשימה ממוספרת עם
DIGIT ,
ALPHA
ו-ROMAN
גליפים מספריים עבור 3 הרמות הראשונות של סידור הרשימות, ולאחר מכן נקודות.
|
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS
|
רשימה ממוספרת עם
DIGIT ,
ALPHA
ו-ROMAN
גליפים מספריים ל-3 רמות הסידור הראשונות של הרשימות, ואחריה סוגריים.
|
NUMBERED_DIGIT_NESTED
|
רשימה ממוספרת עם DIGIT גליפים מספריים המופרדים בנקודות, כאשר כל רמת קינון משתמשת בגליף של רמת הדירוג הקודמת כקידומת. לדוגמה: '1.', '1.1.', '2.', '2.2'.
|
NUMBERED_UPPERALPHA_ALPHA_ROMAN
|
רשימה ממוספרת עם
UPPERALPHA ,
ALPHA
ו-ROMAN
גליפים מספריים עבור 3 הרמות הראשונות של סידור הרשימות, ולאחר מכן נקודות.
|
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT
|
רשימה ממוספרת עם
UPPERROMAN ,
UPPERALPHA
ו-DIGIT
גליפים מספריים עבור 3 הרמות הראשונות של סידור הרשימות, ולאחר מכן נקודות.
|
NUMBERED_ZERODIGIT_ALPHA_ROMAN
|
רשימה ממוספרת עם
ZERODIGIT ,
ALPHA
ו-ROMAN
גליפים מספריים עבור 3 הרמות הראשונות של סידור הרשימות, ולאחר מכן נקודות.
|
החלפת כל הצורות עם ImageRequest
החלפת כל הצורות שתואמות לקריטריונים הנתונים בתמונה שסופקה.
התמונות מלבנות את הצורות המלבניות לאחר שהן מוכנסות למצגת, והן לא מחולקות לצורות.
ייצוג JSON |
---|
{ "replaceMethod": enum ( |
שדות | |
---|---|
replaceMethod
|
שיטת ההחלפה.
הוצאה משימוש
: במקומה יש להשתמש באפשרות
אם ציינת את השדה
|
imageReplaceMethod
|
שיטת החלפת התמונות.
אם ציינת את השדה
אם לא מציינים ערך עבור אם לא ציינת ערכים, ייעשה שימוש ב-CENTER_INSIDE. |
pageObjectIds[]
|
אם לא ריק, מגביל את ההתאמות לרכיבי דף רק בדפים הנתונים.
מחזירה שגיאת 400 של בקשה שגויה אם מקבלים את מזהה אובייקט הדף של
|
שדה איחוד
criteria . הקריטריונים שהצורות צריכות להתאים להן כדי שיוחלפו.
criteria
יכול להיות רק אחד מהבאים:
|
|
containsText
|
אם היא מוגדרת, הבקשה הזו תחליף את כל הצורות שמכילות את הטקסט הנתון. |
שדה איחוד
image_source . סוג מקור התמונה.
image_source
יכול להיות רק אחד מהבאים:
|
|
imageUrl
|
כתובת ה-URL של התמונה. התמונה מאוחזרת פעם אחת בזמן ההוספה, ועותק נשמר לתצוגה בתוך המצגת. התמונות חייבות להיות קטנות מ-50MB והגודל שלהן לא יכול לחרוג מ-25 מגה פיקסל. הן צריכות להיות בפורמט PNG, JPEG או GIF.
כתובת ה-URL שצוינה יכולה להיות באורך של 2KB לכל היותר. כתובת ה-URL עצמה נשמרת עם התמונה ונחשף באמצעות השדה |
שיטת החלפה
שיטת ההחלפה.
טיפוסים בני מנייה (enum) | |
---|---|
CENTER_INSIDE
|
גודל התמונה משתנה ומרכז אותה לגבולות של הצורה המקורית ושומר על יחס הגובה-רוחב של התמונה. ייתכן שהגודל של התמונה לאחר עיבוד יהיה קטן יותר מצורת הצורה. זוהי שיטת ברירת המחדל כאשר לא מצוין ערך. |
CENTER_CROP
|
שינוי הגודל והמרכז של התמונה כדי למלא את הגבולות של הצורה המקורית. יכול להיות שהתמונה תיחתך כדי למלא את הצורה. הגודל של התמונה המעובד יהיה זהה לזה של הצורה המקורית. |
שיטת החלפת התמונה
שיטת החלפת התמונות.
טיפוסים בני מנייה (enum) | |
---|---|
IMAGE_REPLACE_METHOD_UNSPECIFIED
|
שיטה לא מוגדרת להחלפת תמונות. אין להשתמש בערך הזה. |
CENTER_INSIDE
|
גודל התמונה משתנה ומרכז אותה לגבולות של הצורה המקורית ושומר על יחס הגובה-רוחב של התמונה. ייתכן שהגודל של התמונה לאחר עיבוד יהיה קטן יותר מצורת הצורה. זוהי שיטת ברירת המחדל כאשר לא מצוין ערך. |
CENTER_CROP
|
שינוי הגודל והמרכז של התמונה כדי למלא את הגבולות של הצורה המקורית. יכול להיות שהתמונה תיחתך כדי למלא את הצורה. הגודל של התמונה המעובד יהיה זהה לצורתו המקורית. |
בקשה כפולה של אובייקט
משכפל שקף או רכיב דף.
כשהעותק משוכפל, השקף שנוצר נוצר מיד לאחר השקף שצוין. לאחר שכפול של רכיב דף, העותק הכפול ימוקם באותו דף באותו מיקום כמו המקור.
ייצוג JSON |
---|
{ "objectId": string, "objectIds": { string: string, ... } } |
שדות | |
---|---|
objectId
|
מזהה האובייקט לשכפול. |
objectIds
|
האובייקט הכפול עשוי להכיל אובייקטים אחרים, למשל בעת שכפול שקף או רכיב של דף קבוצה. מפה זו מגדירה את אופן יצירת המזהים של אובייקטים כפולים: המפתחות הם המזהים של האובייקטים המקוריים והערכים שלהם הם המזהים שיוקצו לאובייקט הכפול התואם. אפשר גם לציין את המזהה של אובייקט המקור במפה הזו, ולהשתמש באותו ערך של השדה
כל המפתחות חייבים להתאים למזהים הקיימים במצגת. כל הערכים חייבים להיות ייחודיים במצגת, והם חייבים להתחיל בתו אלפאנומרי או בקו תחתון (תואם לביטוי הרגולרי
אם מזהים כלשהם של אובייקטי מקור מושמטים מהמפה, יוקצה מזהה אקראי חדש. אם המפה ריקה או לא מוגדרת, כל האובייקטים הכפולים יקבלו מזהה אקראי חדש. |
עדכון TextTextStyle
ייצוג JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
שדות | |
---|---|
objectId
|
מזהה האובייקט של הצורה או הטבלה שמכילות את הטקסט לעיצוב. |
cellLocation
|
מיקום התא בטבלה שמכיל את הטקסט לעיצוב. אם
|
style
|
הסגנונות שרוצים להגדיר בטקסט. אם הערך של סגנון מסוים תואם לזה של ההורה, הסגנון הזה יקבל בירושה.
שינויים מסוימים בסגנון הטקסט עשויים לגרום לשינויים אחרים שנועדו לשקף את התנהגות העורך של Slides. למידע נוסף, אפשר לעיין במסמכי התיעוד של |
textRange
|
טווח הטקסט לעיצוב. ניתן להרחיב את הטווח כך שיכלול שורות חדשות סמוכות. אם הטווח מכיל רק פסקה ששייכת לרשימה, תבליט הפסקה מעודכן גם הוא בסגנון הטקסט התואם. |
fields
|
השדות שצריך לעדכן.
יש לציין לפחות שדה אחד. השורש
לדוגמה, כדי לעדכן את סגנון הטקסט למודגש, צריך להגדיר את הערך כדי לאפס נכס לערך ברירת המחדל, צריך לכלול את שם השדה שלו במסכה של השדה, אבל להשאיר את השדה עצמו לא מוגדר. |
החלפת כל הצורות עם SheetsChartRequest
החלפת כל הצורות שתואמות לקריטריונים שהוגדרו בתרשים Google Sheets שצוין. התרשים יוגדל ומרכז כך שיתאים לגבולות של הצורה המקורית.
הערה: כדי להחליף צורות בתרשים, צריך לפחות אחד מהגיליונות האלקטרוניים.readonly, sheets, drive.readonly או היקפי הרשאות של OAuth.
ייצוג JSON |
---|
{ "containsText": { object ( |
שדות | |
---|---|
containsText
|
הקריטריונים שהצורות צריכות להתאים להן כדי שיוחלפו. הבקשה תחליף את כל הצורות שמכילות את הטקסט הנתון. |
spreadsheetId
|
המזהה של הגיליון האלקטרוני ב-Google Sheets שמכיל את התרשים. |
chartId
|
המזהה של התרשים הספציפי בגיליון האלקטרוני של Google Sheets. |
linkingMode
|
המצב שבו התרשים מקושר לגיליון האלקטרוני המקורי. אם לא צוין אחרת, התרשים יהיה תמונה שאינה מקושרת. |
pageObjectIds[]
|
אם לא ריק, מגביל את ההתאמות לרכיבי דף רק בדפים הנתונים.
מחזירה שגיאת 400 של בקשה שגויה אם מקבלים את מזהה אובייקט הדף של
|
מצב קישור
המצב שבו התרשים מקושר לגיליון האלקטרוני המקורי.
טיפוסים בני מנייה (enum) | |
---|---|
NOT_LINKED_IMAGE
|
התרשים לא משויך לגיליון האלקטרוני המקורי ולא ניתן לעדכן אותו. תרשים שלא מקושר אליו יתווסף כתמונה. |
LINKED
|
קישור התרשים מאפשר את עדכוןו, ושותפי עריכה אחרים יראו קישור לגיליון האלקטרוני. |
DeleteParagraphbulletsRequest
מחיקת תבליטים מכל הפסקאות שחופפות לאינדקס הטקסט הנתון
range
.
רמת הסידור של כל פסקה תישמר באופן חזותי על ידי הוספת כניסת פסקה בתחילת הפסקה המתאימה.
ייצוג JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
שדות | |
---|---|
objectId
|
מזהה האובייקט של הצורה או הטבלה שמכילות את הטקסט שממנו יימחקו תבליטים. |
cellLocation
|
המיקום האופציונלי של תא הטבלה אם הטקסט שיש לשנות נמצא בתא בטבלה. אם השדה קיים, ה-ObjectId חייב להתייחס לטבלה. |
textRange
|
טווח הטקסט של מחיקת תבליטים, על סמך
|
עדכוןParagraphStyleRequest
עדכון הסגנון של כל הפסקאות בטווח של Shape
או Table
שחופפים לטווח הנתון של אינדקס הטקסט.
ייצוג JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
שדות | |
---|---|
objectId
|
מזהה האובייקט של הצורה או הטבלה שמכילות את הטקסט לעיצוב. |
cellLocation
|
המיקום של התא בטבלה שמכיל את הפסקאות שרוצים לעצב. אם
|
style
|
הסגנון של הפסקה. |
textRange
|
טווח הטקסט בסגנון של הפסקה. |
fields
|
השדות שצריך לעדכן.
יש לציין לפחות שדה אחד. השורש
לדוגמה, כדי לעדכן את יישור הפסקה, מגדירים את
כדי לאפס נכס לערך ברירת המחדל, צריך לכלול את שם השדה שלו במסכה של השדה, אבל להשאיר את השדה עצמו לא מוגדר. |
עדכוןTTBorderPropertiesRequest
עדכון המאפיינים של גבולות הטבלה בTable
.
ייצוג JSON |
---|
{ "objectId": string, "tableRange": { object ( |
שדות | |
---|---|
objectId
|
מזהה האובייקט של הטבלה. |
tableRange
|
טווח הטבלאות שמייצג את קבוצת המשנה של הטבלה שעליה מוחלים העדכונים. אם לא מציינים טווח בטבלה, העדכונים יחולו על כל הטבלה. |
borderPosition
|
מיקום הגבול בטווח הטבלה שיש להחיל על העדכונים. אם לא צוין מיקום גבול, העדכונים יחולו על כל הגבולות בטווח הטבלה. |
tableBorderProperties
|
המאפיינים של גבול הטבלה שיש לעדכן. |
fields
|
השדות שצריך לעדכן.
יש לציין לפחות שדה אחד. השורש
לדוגמה, כדי לעדכן את צבע המילוי המלא של גבול הטבלה, מגדירים את הערך כדי לאפס נכס לערך ברירת המחדל, צריך לכלול את שם השדה שלו במסכה של השדה, אבל להשאיר את השדה עצמו לא מוגדר. |
מיקום גבול
המיקום של גבול הטבלה.
טיפוסים בני מנייה (enum) | |
---|---|
ALL
|
כל הגבולות בטווח. |
BOTTOM
|
גבולות בתחתית הטווח. |
INNER
|
גבולות בתוך הטווח. |
INNER_HORIZONTAL
|
גבולות אופקיים בתוך הטווח. |
INNER_VERTICAL
|
גבולות אנכיים בתוך הטווח. |
LEFT
|
גבולות מימין לטווח. |
OUTER
|
גבולות מחוץ לטווח. |
RIGHT
|
גבולות משמאל לטווח. |
TOP
|
גבולות בחלק העליון של הטווח. |
עדכוןTTColumnColumnRequest
עדכון המאפיינים בעמודה Table
.
ייצוג JSON |
---|
{
"objectId": string,
"columnIndices": [
integer
],
"tableColumnProperties": {
object (
|
שדות | |
---|---|
objectId
|
מזהה האובייקט של הטבלה. |
columnIndices[]
|
רשימת האינדקסים מבוססי האפס שמציינת אילו עמודות יש לעדכן. אם לא תספקו אינדקסים, כל העמודות בטבלה יעודכנו. |
tableColumnProperties
|
המאפיינים של עמודת הטבלה שיש לעדכן.
אם הערך של
|
fields
|
השדות שצריך לעדכן.
יש לציין לפחות שדה אחד. השורש
לדוגמה, כדי לעדכן את רוחב העמודה, מגדירים את אם ''ColumnWidth'' כלול במסכה של השדה אך המאפיין לא מוגדר, רוחב העמודה יהיה ברירת המחדל ל-406,400 EMU (32 נקודות). |
UpdateTableRowPropertiesRequest
עדכון המאפיינים של שורה Table
.
ייצוג JSON |
---|
{
"objectId": string,
"rowIndices": [
integer
],
"tableRowProperties": {
object (
|
שדות | |
---|---|
objectId
|
מזהה האובייקט של הטבלה. |
rowIndices[]
|
רשימת האינדקסים שמבוססים על אפס שמציינות אילו שורות לעדכן. אם לא תספקו אינדקסים, כל השורות בטבלה יעודכנו. |
tableRowProperties
|
המאפיינים של שורת הטבלה שיש לעדכן. |
fields
|
השדות שצריך לעדכן.
יש לציין לפחות שדה אחד. השורש
למשל, כדי לעדכן את גובה השורה המינימלי, מגדירים את הערך אם 'minRowHeight' כלול במסכה של השדה אבל המאפיין לא מוגדר, גובה השורה המינימלי יהיה 0 כברירת מחדל. |
בקשת MergeTableCellsRequest
מיזוג תאים בתוך
Table
.
ייצוג JSON |
---|
{
"objectId": string,
"tableRange": {
object (
|
שדות | |
---|---|
objectId
|
מזהה האובייקט של הטבלה. |
tableRange
|
טווח הטבלה שמציין אילו תאים בטבלה יש למזג. כל טקסט בתאים שימוזגו יחובר ויאוחסן בתא הימני העליון של הטווח. אם הטווח הוא לא מלבני (מצב זה יכול להתרחש במקרים מסוימים שבהם הטווח מכסה תאים שכבר ממוזגים), מוחזרת שגיאה 400 של בקשה שגויה. |
ביטול המיזוג של בקשה
ביטול המיזוג של תאים ב-Table
.
ייצוג JSON |
---|
{
"objectId": string,
"tableRange": {
object (
|
שדות | |
---|---|
objectId
|
מזהה האובייקט של הטבלה. |
tableRange
|
טווח הטבלה שמציין אילו תאים בטבלה יש לבטל. כל התאים שמוזגו בטווח הזה לא ימוזגו, ותאים שכבר לא מוזגו לא יושפעו. אם בטווח אין תאים שמוזגו, הבקשה לא תעשה דבר. אם יש טקסט באחד מהתאים שמוזגו, הטקסט יישאר בתא השמאלי העליון ("head") של הבלוק שמתקבל מהמיזוג של התאים. |
אובייקט קבוצתי
מקבצת אובייקטים כדי ליצור קבוצת אובייקטים. לדוגמה, קיבוץ
PageElements
כדי ליצור
Group
באותו דף יחד עם כל הילדים.
ייצוג JSON |
---|
{ "groupObjectId": string, "childrenObjectIds": [ string ] } |
שדות | |
---|---|
groupObjectId
|
מזהה אובייקט שסופק על ידי המשתמש ויצור את הקבוצה.
אם מציינים מזהה, הוא צריך להיות ייחודי בין כל הדפים ורכיבי הדפים במצגת. המזהה חייב להתחיל בתו אלפאנומרי או בקו תחתון (תואם לביטוי רגולרי
אם לא תציינו מזהה, ייווצר מזהה ייחודי. |
childrenObjectIds[]
|
מזהי האובייקטים של האובייקטים שיש לקבץ.
אפשר לקבץ רק רכיבים בדף. בכל דף צריכים להיות לפחות שני רכיבים שלא שייכים לקבוצה אחרת. אי אפשר לקבץ חלק מרכיבי הדף, כמו
|
ביטול הקיבוץ של בקשה
ביטול הקיבוץ של אובייקטים, כמו
groups
.
ייצוג JSON |
---|
{ "objectIds": [ string ] } |
שדות | |
---|---|
objectIds[]
|
מזהי האובייקטים לקיבוץ.
אפשר לבטל את הקיבוץ של
|
עדכון PageElementAltTextRequest
עדכון השם או התיאור של הטקסט החלופי ב-page element
.
ייצוג JSON |
---|
{ "objectId": string, "title": string, "description": string } |
שדות | |
---|---|
objectId
|
מזהה האובייקט של רכיב הדף שעליו העדכונים חלים. |
title
|
כותרת הטקסט החלופית המעודכנת של רכיב הדף. אם המדיניות לא מוגדרת, הערך הקיים יישמר. הכותר חשוף לקוראים של המסך ולממשקי נגישות אחרים. יש להשתמש בערכים קריאים אנושיים שקשורים לתוכן של רכיב הדף. |
description
|
תיאור הטקסט החלופי המעודכן של רכיב הדף. אם המדיניות לא מוגדרת, הערך הקיים יישמר. התיאור חשוף לקוראי מסך ולממשקי נגישות אחרים. יש להשתמש בערכים קריאים אנושיים שקשורים לתוכן של רכיב הדף. |
החלפת תמונה
מחליפה תמונה קיימת בתמונה חדשה.
החלפת תמונה גורמת להסרת
image effects
מהתמונה הקיימת.
ייצוג JSON |
---|
{ "imageObjectId": string, "imageReplaceMethod": enum ( |
שדות | |
---|---|
imageObjectId
|
המזהה של התמונה הקיימת שיוחלף. ניתן לאחזר את המזהה מהתשובה של בקשת אחזור. |
imageReplaceMethod
|
שיטת ההחלפה. |
שדה איחוד
image_source . סוג מקור התמונה.
image_source
יכול להיות רק אחד מהבאים:
|
|
url
|
כתובת ה-URL של התמונה. התמונה מאוחזרת פעם אחת בזמן ההוספה, ועותק נשמר לתצוגה בתוך המצגת. התמונות חייבות להיות קטנות מ-50MB ובגודל של עד 25 מגה פיקסל. הן צריכות להיות בפורמט PNG, JPEG או GIF.
כתובת ה-URL שסופקה לא יכולה לחרוג מ- 2KB. כתובת ה-URL נשמרת עם התמונה, ונחשפת דרך השדה |
UpdateSlidePropertiesRequest
עדכון המאפיינים של שקף.
ייצוג JSON |
---|
{
"objectId": string,
"slideProperties": {
object (
|
שדות | |
---|---|
objectId
|
מזהה האובייקט של השקף שעליו חל העדכון. |
slideProperties
|
מאפייני השקף שיש לעדכן. |
fields
|
השדות שצריך לעדכן.
יש לציין לפחות שדה אחד. הרמה הבסיסית 'slideProperties' היא משתמעת ואין לציין אותה. ניתן להשתמש
ב-
לדוגמה, כדי לבדוק אם דילגתם על שקף, מגדירים את כדי לאפס נכס לערך ברירת המחדל, צריך לכלול את שם השדה שלו במסכה של השדה, אבל להשאיר את השדה עצמו לא מוגדר. |
UpdatePageElementsZOrderRequest
עדכון סדר ה-Z של רכיבי הדף. סדר ה-Z הוא סדר האלמנטים בדף מההתחלה ועד הסוף. רכיב הדף בחזית עשוי לכלול את הרכיבים שמאחוריו.
ייצוג JSON |
---|
{
"pageElementObjectIds": [
string
],
"operation": enum (
|
שדות | |
---|---|
pageElementObjectIds[]
|
מזהי האובייקטים של רכיבי הדף שיש לעדכן. כל רכיבי הדף חייבים להיות באותו הדף ואסור לקבץ אותם. |
operation
|
פעולה בסדר Z שצריך להחיל על רכיבי הדף. כשמחילים את הפעולה על מספר רכיבי דף, פקודות ה-Z היחסיות בתוך רכיבי הדף האלה לפני ביצוע הפעולה. |
ZOrderOperation
הפעולה לעדכון סידור Z של רכיב דף.
טיפוסים בני מנייה (enum) | |
---|---|
Z_ORDER_OPERATION_UNSPECIFIED
|
פעולה לא מוגדרת. |
BRING_TO_FRONT
|
מפנה את רכיבי הדף לחלק הקדמי של הדף. |
BRING_FORWARD
|
הצגת הרכיבים בדף קדימה ברכיב אחד ביחס לרכיב הקיצוני ביותר ברכיבי הדף שצוינו. |
SEND_BACKWARD
|
התג שולח את הרכיבים בדף אחורה ברכיב אחד, ביחס לאחרם ברכיב הדף שצוין. |
SEND_TO_BACK
|
שליחת רכיבי הדף לחלקו האחורי של הדף. |
עדכון LineLineCategoryRequest
עדכון הקטגוריה של line
.
ייצוג JSON |
---|
{
"objectId": string,
"lineCategory": enum (
|
שדות | |
---|---|
objectId
|
מזהה האובייקט של השורה שעליה חל העדכון.
ניתן לעדכן רק קו עם
לאחר עדכון הקטגוריה ניתן יהיה לנתב מחדש את הקו. |
lineCategory
|
קטגוריית הקו שאליה תתבצע העדכון.
התוכן המדויק
|
ניתוב מחדשRequestRequest
מנתב מחדש
line
כך שהוא יהיה מחובר לשני אתרי החיבור הקרובים ביותר ברכיבי הדפים המחוברים.
ייצוג JSON |
---|
{ "objectId": string } |
שדות | |
---|---|
objectId
|
מזהה האובייקט של הנתיב לניתוב מחדש.
ניתן לנתב רק קו עם |