בקשה
עדכון יחיד שיחול על מסמך.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה האיחוד
request . הבקשה הספציפית שרוצים להגיש. חובה למלא רק שדה אחד.
request יכול להיות רק אחת מהאפשרויות הבאות:
|
|
replace
|
החלפת כל המופעים של הטקסט שצוין. |
insert
|
מוסיפה טקסט במיקום שצוין. |
update
|
עדכון סגנון הטקסט בטווח שצוין. |
create
|
יוצרת סמלי נקודה-קו לפסקה. |
delete
|
מחיקת תוויות של נקודות מפסיק מהפסקאות. |
create
|
יצירת טווח בעל שם. |
delete
|
מחיקה של טווח תאים בעל שם. |
update
|
עדכון סגנון הפסקה בטווח שצוין. |
delete
|
מחיקת תוכן מהמסמך. |
insert
|
הוספת תמונה בתוך הטקסט במיקום שצוין. |
insert
|
הוספת טבלה במיקום שצוין. |
insert
|
מוסיפה שורה ריקה לטבלה. |
insert
|
מוסיפה עמודה ריקה לטבלה. |
delete
|
מחיקה של שורה מטבלה. |
delete
|
מחיקה של עמודה מטבלה. |
insert
|
הוספת מעבר דף במיקום שצוין. |
delete
|
מחיקה של אובייקט ממוקם מהמסמך. |
update
|
עדכון המאפיינים של עמודות בטבלה. |
update
|
עדכון הסגנון של תאים בטבלה. |
update
|
עדכון סגנון השורה בטבלה. |
replace
|
החלפת תמונה במסמך. |
update
|
עדכון הסגנון של המסמך. |
merge
|
מיזוג תאים בטבלה. |
unmerge
|
ביטול המיזוג של תאים בטבלה. |
create
|
יצירת כותרת. |
create
|
יצירת כותרת תחתונה. |
create
|
יצירת הערת שוליים. |
replace
|
מחליפה את התוכן בטווח בעל שם. |
update
|
עדכון סגנון הקטע של הטווח שצוין. |
insert
|
הוספת מעבר קטע במיקום שצוין. |
delete
|
מחיקה של כותרת מהמסמך. |
delete
|
מחיקת כותרת תחתונה מהמסמך. |
pin
|
מעדכנת את מספר שורות הכותרת המוצמדות בטבלה. |
ReplaceAllTextRequest
הפונקציה מחליפה את כל המופעים של טקסט שתואמים לקריטריון מסוים ב-replace text
.
ייצוג ב-JSON |
---|
{ "replaceText": string, "tabsCriteria": { object ( |
שדות | |
---|---|
replace
|
הטקסט שיחליף את הטקסט התואם. |
tabs
|
זה שינוי אופציונלי. הקריטריונים שמשמשים כדי לציין באילו כרטיסיות תתבצע ההחלפה. אם לא מציינים את הפרמטר הזה, ההחלפה תחול על כל הכרטיסיות. במסמך שמכיל כרטיסייה אחת:
במסמך שמכיל כמה כרטיסיות:
|
שדה האיחוד
criteria . הקריטריונים שבהם נעשה שימוש כדי להתאים את הטקסט שרוצים להחליף.
criteria יכול להיות רק אחת מהאפשרויות הבאות:
|
|
contains
|
חיפוש טקסט במסמך שמתאים למחרוזת המשנה הזו. |
SubstringMatchCriteria
קריטריון שתואמת למחרוזת טקסט ספציפית במסמך.
ייצוג JSON |
---|
{ "text": string, "matchCase": boolean } |
שדות | |
---|---|
text
|
הטקסט שרוצים לחפש במסמך. |
match
|
מציין אם החיפוש צריך להתייחס לאותיות רישיות:
|
TabsCriteria
קריטריון שמציין באילו כרטיסיות הבקשה תופעל.
ייצוג JSON |
---|
{ "tabIds": [ string ] } |
שדות | |
---|---|
tab
|
רשימת מזהי הכרטיסיות שבהן הבקשה מתבצעת. |
InsertTextRequest
מוסיפה טקסט במיקום שצוין.
ייצוג JSON |
---|
{ "text": string, // Union field |
שדות | |
---|---|
text
|
הטקסט שרוצים להוסיף.
הוספת תו של שורה חדשה תיצור באופן משתמע סגנונות הטקסט של הטקסט שהוכנס ייקבעו באופן אוטומטי, בדרך כלל תוך שמירה על סגנון הטקסט הסמוך. ברוב המקרים, סגנון הטקסט של הטקסט שהוכנס יתאים לטקסט שמופיע מיד לפני מדד ההוספה. תווי בקרה מסוימים (U+0000-U+0008, U+000C-U+001F) ותווים מאזור השימוש הפרטי של מישור Unicode Basic Multilingual (U+E000-U+F8FF) יוסרו מהטקסט שהוכנס. |
שדה האיחוד
insertion_location . המיקום שבו הטקסט יתווסף.
insertion_location יכול להיות רק אחת מהאפשרויות הבאות:
|
|
location
|
מאכלס את הטקסט באינדקס ספציפי במסמך.
צריך להוסיף טקסט בתוך גבולות של |
end
|
הטקסט יתווסף בסוף כותרת עליונה, כותרת תחתונה, הערת שוליים או גוף המסמך. |
מיקום
מיקום מסוים במסמך.
ייצוג ב-JSON |
---|
{ "segmentId": string, "index": integer, "tabId": string } |
שדות | |
---|---|
segment
|
המזהה של הכותרת העליונה, הכותרת התחתונה או הערת השוליים שבהן נמצא המיקום. מזהה מקטע ריק מציין את גוף המסמך. |
index
|
האינדקס שמתחיל באפס, ביחידות קוד UTF-16.
המדד הוא ביחס לתחילת הקטע שצוין על ידי |
tab
|
הכרטיסייה שבה נמצא המיקום. אם לא מציינים את הפרמטר הזה, הבקשה חלה על הכרטיסייה הראשונה. במסמך שמכיל כרטיסייה אחת:
במסמך שמכיל כמה כרטיסיות:
|
EndOfSegmentLocation
מיקום בסוף גוף, כותרת עליונה, כותרת תחתונה או הערת שוליים. המיקום נמצא מיד לפני שורת השוליים האחרונה בקטע המסמך.
ייצוג ב-JSON |
---|
{ "segmentId": string, "tabId": string } |
שדות | |
---|---|
segment
|
המזהה של הכותרת העליונה, הכותרת התחתונה או הערת השוליים במיקום הזה. מזהה מקטע ריק מציין את גוף המסמך. |
tab
|
הכרטיסייה שבה נמצא המיקום. אם השדה הזה לא יצוין, הבקשה תחול על הכרטיסייה הראשונה. במסמך שמכיל כרטיסייה אחת:
במסמך שמכיל כמה כרטיסיות:
|
UpdateTextStyleRequest
מעדכנים את הסגנון של הטקסט.
ייצוג ב-JSON |
---|
{ "textStyle": { object ( |
שדות | |
---|---|
text
|
הסגנונות שרוצים להגדיר לטקסט. אם הערך של סגנון מסוים תואם לזה של סגנון ההורה, הסגנון יוגדר בירושה.
אם תבצעו שינויים מסוימים בסגנון הטקסט, יכול להיות ששינויים אחרים ישקפו את ההתנהגות של עורך Docs. למידע נוסף, עיינו במסמכי התיעוד של |
fields
|
השדות שצריך לעדכן.
צריך לציין שדה אחד לפחות. השורש
לדוגמה, כדי לעדכן את סגנון הטקסט למודגש, צריך להגדיר את כדי לאפס נכס לערך ברירת המחדל שלו, צריך לכלול את שם השדה שלו במסיכת השדה, אבל להשאיר את השדה עצמו ללא הגדרה. |
שדה האיחוד
insertion_location . סוג הטווח שבו סגנון הטקסט יתעדכן.
insertion_location יכול להיות רק אחת מהאפשרויות הבאות:
|
|
range
|
טווח הטקסט שרוצים לעצב. ניתן להרחיב את הטווח כך שיכלול שורות חדשות סמוכות. אם הטווח מכיל פסקה שלמה ששייכת לרשימה, גם פסיק הפסקה של הפסקה מתעדכן בסגנון הטקסט התואם. אי אפשר להוסיף טווחים בתוך UpdateTextStyleRequest יחסי. |
CreateParagraphBulletsRequest
יצירת תבליטים לכל הפסקאות שחופפות לטווח הנתון.
רמת ההטמעה של כל הפסקה תיקבע על ידי ספירת הכרטיסיות שלפני כל הפסקה. כדי למנוע רווח מיותר בין הנקודה והפסקה המתאימה, הבקשה הזו מסירה את התווים האלה. הפעולה הזו עשויה לשנות את האינדקסים של חלקים מהטקסט.
אם הפסקה שמופיעה לפני הפסקות שמתעדכנות נמצאת ברשימה עם הגדרה מוגדרת מראש תואמת, הפסקות שמתעדכנות מתווספות לרשימה הקודמת הזו.
ייצוג JSON |
---|
{ "range": { object ( |
שדות | |
---|---|
range
|
הטווח שבו רוצים להחיל את הגדרת התבליטים המוגדרת מראש. |
bullet
|
סוגי הסמלים של הנקודות ליד הטקסט שישמשו. |
BulletGlyphPreset
תבניות מוגדרות מראש של גליפים של תבליטים לרשימות.
בדוגמאות האלה נעשה שימוש בסוגים הבאים של סמלי נקודה:
-
ARROW
: חץ שתואם לנקודת קוד בפורמט Unicode U+2794 -
ARROW3D
: חץ עם צללית תלת-ממדית, התואם למיקום תו (code point) U+27a2 ב-Unicode -
CHECKBOX
: ריבוע חלול, התואם למיקום תו (code point) ב-Unicode U+274f -
CIRCLE
: עיגול חלול, התואם למיקום תו (code point) ב-Unicode U+25cb -
DIAMOND
: ריבוע מרובע מלא, התואם למיקום תו (code point) U+25c6 ב-Unicode -
DIAMONDX
: יהלום עם 'x', שתואם למיקום תו (code point) של Unicode U+2756 -
HOLLOWDIAMOND
: יהלום חלול, שתואם לנקודת הקוד של Unicode U+25c7 -
DISC
: עיגול מלא, שתואם לנקודת קוד בפורמט Unicode U+25cf -
SQUARE
: ריבוע מלא, שתואם לנקודת קוד של Unicode U+25a0 -
STAR
: כוכב, התואם למיקום התו (code point) U+2605 ב-Unicode -
ALPHA
: אות קטנה, כמו 'a', 'b' או 'c'. -
UPPERALPHA
: אות רישית, כמו 'A', 'B' או 'C'. -
DECIMAL
: מספר, כמו '1', '2' או '3'. -
ZERODECIMAL
: מספר שבו למספרים חד-ספרתיים מצורף אפס בתחילית, כמו '01', '02' או '03'. מספרים שיש להם יותר מספרה אחת לא קידומת אפס. -
ROMAN
: ספרה רומית קטנה, כמו 'i', 'ii' או 'iii'. -
UPPERROMAN
: ספרה רומית באותיות רישיות, כמו 'I', 'II' או 'III'. -
LEFTTRIANGLE
: משולש שמצביע שמאלה, התואם למיקום תו (code point) U+25c4 ב-Unicode
טיפוסים בני מנייה (enum) | |
---|---|
BULLET_GLYPH_PRESET_UNSPECIFIED
|
לא צוין הגדרה מוגדרת מראש של הגליף של פסיק הירי. |
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_DECIMAL_ALPHA_ROMAN
|
רשימה ממוספרת עם תווים ספרתיים של DECIMAL , ALPHA ו-ROMAN ל-3 רמות הדירוג הראשונות של הרשימה, ואחריהם נקודות.
|
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS
|
רשימה ממוספרת עם תווים ספרתיים של DECIMAL , ALPHA ו-ROMAN ל-3 רמות הדירוג הראשונות של הרשימה, ואז סוגריים.
|
NUMBERED_DECIMAL_NESTED
|
רשימה ממוספרת עם
DECIMAL
גליפים מספריים שמופרדים באמצעות נקודות, כאשר כל רמת קינון משתמשת בגליף של רמת הסידור הקודמת כקידומת. לדוגמה: '1.', '1.1.', '2.', '2.2.'.
|
NUMBERED_UPPERALPHA_ALPHA_ROMAN
|
רשימה ממוספרת עם תווים ספרתיים של UPPERALPHA , ALPHA ו-ROMAN ל-3 רמות הדירוג הראשונות של הרשימה, ואחריהם נקודות.
|
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL
|
רשימה ממוספרת עם תווים ספרתיים של UPPERROMAN , UPPERALPHA ו-DECIMAL ל-3 רמות הדירוג הראשונות של הרשימה, ואחריהם נקודות.
|
NUMBERED_ZERODECIMAL_ALPHA_ROMAN
|
רשימה ממוספרת עם גליפים מספריים ZERODECIMAL , ALPHA ו-ROMAN עבור 3 רמות הקינון הראשונות ברשימה, ואחריה נקודות.
|
DeleteParagraphBulletsRequest
המחיקה של הנקודות מכל הקטעים שחופפים לטווח הנתון.
רמת הסידור הפנימי של כל פסקה תישמר מבחינה חזותית על ידי הוספת כניסה בתחילת הפסקה המתאימה.
ייצוג ב-JSON |
---|
{
"range": {
object ( |
שדות | |
---|---|
range
|
הטווח שממנו רוצים למחוק את הנקודות. |
CreateNamedRangeRequest
הפונקציה יוצרת את הערך NamedRange
שמפנה לטווח שצוין.
ייצוג JSON |
---|
{
"name": string,
"range": {
object ( |
שדות | |
---|---|
name
|
השם של NamedRange. השמות לא חייבים להיות ייחודיים. השמות חייבים להכיל לפחות תו אחד ולא יותר מ-256 תווים, נמדדים ביחידות קוד UTF-16. |
range
|
הטווח שבו רוצים להחיל את השם. |
DeleteNamedRangeRequest
מחיקה של NamedRange
.
ייצוג ב-JSON |
---|
{ "tabsCriteria": { object ( |
שדות | |
---|---|
tabs
|
זה שינוי אופציונלי. הקריטריונים שמשמשים לציון הכרטיסיות שבהן צריך למחוק את הטווח. אם לא מציינים את הפרמטר הזה, מחיקת הטווח חלה על כל הכרטיסיות. במסמך שמכיל כרטיסייה אחת:
במסמך שמכיל כמה כרטיסיות:
|
שדה האיחוד
named_range_reference . הערך שקובע אילו טווחים או טווחים למחוק. צריך להגדיר רק ערך אחד.
named_range_reference
יכול להיות רק אחת מהאפשרויות הבאות:
|
|
named
|
המזהה של טווח התאים בעל השם למחיקה. |
name
|
שמות הטווחים למחיקה. כל טווחי התאים בעלי השם הנתון יימחקו. |
UpdateParagraphStyleRequest
עדכון העיצוב של כל הפסקאות שחופפות לטווח הנתון.
ייצוג ב-JSON |
---|
{ "paragraphStyle": { object ( |
שדות | |
---|---|
paragraph
|
הסגנונות שיוגדרו בפסקאות.
שינויים מסוימים בסגנון הפסקה עשויים לגרום לשינויים אחרים כדי לשקף את ההתנהגות של עורך Docs. למידע נוסף, עיינו במסמכי התיעוד של |
fields
|
השדות שצריך לעדכן.
צריך לציין שדה אחד לפחות. השורש
לדוגמה, כדי לעדכן את מאפיין ההתאמה של סגנון הפסקה, מגדירים את כדי לאפס נכס לערך ברירת המחדל שלו, צריך לכלול את שם השדה שלו במסיכת השדה, אבל להשאיר את השדה עצמו ללא הגדרה. |
שדה האיחוד
insertion_location . סוג הטווח שבו יתבצע העדכון של סגנון הפסקה.
insertion_location
יכול להיות רק אחת מהאפשרויות הבאות:
|
|
range
|
הטווח שחופף לפסקות שרוצים לעצב. |
DeleteContentRangeRequest
מחיקת תוכן מהמסמך.
ייצוג ב-JSON |
---|
{
"range": {
object ( |
שדות | |
---|---|
range
|
טווח התוכן שרוצים למחוק. מחיקת טקסט שחוצה גבולות של פסקה עשויה לגרום לשינויים בסגנונות של פסקאות, ברשימות, באובייקטים ובסימניות ממוקמים בזמן מיזוג שתי הפסקאות. הניסיון למחוק טווחים מסוימים עלול לגרום למבנה מסמך לא חוקי, ובמקרה כזה תוחזר שגיאה של בקשה שגויה מסוג 400. דוגמאות לבקשות מחיקה לא חוקיות:
|
InsertInlineImageRequest
מוסיפה InlineObject
שמכיל תמונה במיקום הנתון.
ייצוג ב-JSON |
---|
{ "uri": string, "objectSize": { object ( |
שדות | |
---|---|
uri
|
ה-URI של התמונה. התמונה מאוחזרת פעם אחת בזמן ההוספה, ועותק שלה נשמר להצגה בתוך המסמך. התמונות צריכות להיות בגודל של עד 50MB, לא יכולות לחרוג מ-25 מגה-פיקסל וצריכות להיות בפורמט PNG, JPEG או GIF.
ה-URI שצוין חייב להיות גלוי לכולם באורך של עד 2KB. ה-URI עצמו נשמר עם התמונה וחשוף דרך השדה |
object
|
הגודל שבו התמונה אמורה להופיע במסמך. המאפיין הזה הוא אופציונלי, והגודל הסופי של התמונה במסמך נקבע לפי הכללים הבאים: * אם לא צוינו רוחב או גובה, גודל ברירת המחדל של התמונה מחושב על סמך הרזולוציה שלה. * אם מציינים מאפיין אחד, המאפיין השני מחושב כדי לשמור על יחס הגובה-רוחב של התמונה. * אם מציינים גם רוחב וגם גובה, התמונה תתאים לממדים שצוינו תוך שמירה על יחס הגובה-רוחב שלה. |
שדה האיחוד
insertion_location . המיקום שאליו תוכנס התמונה.
insertion_location
יכול להיות רק אחת מהאפשרויות הבאות:
|
|
location
|
הוספת התמונה לאינדקס ספציפי במסמך.
צריך להוסיף את התמונה בתוך גבולות של אי אפשר להוסיף תמונות בתוך הערה שוליים או נוסחה. |
end
|
הטקסט יתווסף בסוף הכותרת העליונה, הכותרת התחתונה או גוף המסמך. אי אפשר להוסיף תמונות מוטבעות בתוך הערה שוליים. |
InsertTableRequest
הוספת טבלה במיקום שצוין.
תו של מעבר שורה יתווסף לפני הטבלה שתתווסף.
ייצוג JSON |
---|
{ "rows": integer, "columns": integer, // Union field |
שדות | |
---|---|
rows
|
מספר השורות בטבלה. |
columns
|
מספר העמודות בטבלה. |
שדה האיחוד
insertion_location . המיקום שבו הטבלה תוכנס.
insertion_location יכול להיות רק אחת מהאפשרויות הבאות:
|
|
location
|
מוסיפה את הטבלה באינדקס ספציפי של מודל. תו של שורת חדשה יוכנס לפני הטבלה שהוכנסה, לכן אינדקס ההתחלה של הטבלה יהיה אינדקס המיקום שצוין + 1.
צריך להוסיף את הטבלה בתוך גבולות של אי אפשר להוסיף טבלאות בתוך הערה שוליים או בתוך משוואה. |
end
|
הוספת הטבלה בסוף הכותרת, הכותרת התחתונה או גוף המסמך. תו של מעבר שורה יתווסף לפני הטבלה שתתווסף. אי אפשר להוסיף טבלאות בתוך הערה שוליים. |
InsertTableRowRequest
הוספת שורה ריקה לטבלה.
ייצוג ב-JSON |
---|
{
"tableCellLocation": {
object ( |
שדות | |
---|---|
table
|
מיקום התא בטבלת העזר שממנו יתווספו שורות. תתווסף שורה חדשה מעל (או מתחת) לשורה שבה נמצא תא העזר. אם תא העזר הוא תא ממוזג, תתווסף שורה חדשה מעל (או מתחת) לתא הממוזג. |
insert
|
הגדרה שקובעת אם להוסיף שורה חדשה מתחת למיקום של התא להפניה.
|
TableCellLocation
המיקום של תא יחיד בטבלה.
ייצוג ב-JSON |
---|
{
"tableStartLocation": {
object ( |
שדות | |
---|---|
table
|
המיקום שבו מתחילה הטבלה במסמך. |
row
|
אינדקס השורות המבוסס על אפס. לדוגמה, האינדקס של השורה השנייה בטבלה הוא 1. |
column
|
אינדקס העמודות שמתחיל ב-0. לדוגמה, העמודה השנייה בטבלה כוללת את אינדקס העמודה 1. |
InsertTableColumnRequest
הוספת עמודה ריקה לטבלה.
ייצוג ב-JSON |
---|
{
"tableCellLocation": {
object ( |
שדות | |
---|---|
table
|
מיקום התא בטבלת ההפניות שממנו העמודות יתווספו. תתווסף עמודה חדשה משמאל (או מימין) לעמודה שבה נמצא תא ההפניה. אם תא ההפניה הוא תא ממוזג, תתווסף עמודה חדשה משמאל (או מימין) לתא הממוזג. |
insert
|
האם להוסיף עמודה חדשה מימין למיקום של תא העזר.
|
DeleteTableRowRequest
מחיקה של שורה מטבלה.
ייצוג ב-JSON |
---|
{
"tableCellLocation": {
object ( |
שדות | |
---|---|
table
|
מיקום התא בטבלת העזר שממנו השורה תימחק. השורה שמתפרסת על התא הזה תימחק. אם מדובר בתא ממוזג שמשתרע על כמה שורות, כל השורות שבהן התא משתרע יימחקו. אם לא נותרו שורות בטבלה אחרי המחיקה הזו, כל הטבלה נמחקת. |
DeleteTableColumnRequest
מחיקה של עמודה מטבלה.
ייצוג JSON |
---|
{
"tableCellLocation": {
object ( |
שדות | |
---|---|
table
|
מיקום התא בטבלת העזר שממנה תימחק העמודה. העמודה שהתא הזה משתרע עליה תימחק. אם התא ממוזג שמתפרס על כמה עמודות, כל העמודות שהתא מתפרס עליהן יימחקו. אם לא נותרו עמודות בטבלה אחרי המחיקה הזו, כל הטבלה נמחקת. |
InsertPageBreakRequest
הוספת מעבר דף ואחריו שורת חדשה במיקום שצוין.
ייצוג ב-JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה האיחוד
insertion_location . המיקום שבו יתווסף מעבר הדף.
insertion_location
יכול להיות רק אחת מהאפשרויות הבאות:
|
|
location
|
הוספת מעבר דף במקום ספציפי במסמך.
צריך להוסיף את מעבר הדף בתוך הגבולות של
אי אפשר להוסיף מעברי דפים בתוך טבלה, משוואה, הערה שוליים, כותרת או כותרת תחתונה. מכיוון שאפשר להוסיף הפסקות דף רק בגוף, השדה |
end
|
הוספת מעבר עמוד בסוף גוף המסמך.
אי אפשר להוסיף הפסקות דף בתוך הערה שוליים, כותרת עליונה או כותרת תחתונה. מכיוון שאפשר להוסיף הפסקות דף רק בגוף, השדה |
DeletePositionedObjectRequest
מחיקה של PositionedObject
מהמסמך.
ייצוג ב-JSON |
---|
{ "objectId": string, "tabId": string } |
שדות | |
---|---|
object
|
המזהה של האובייקט הממוקם שרוצים למחוק. |
tab
|
הכרטיסייה שבה נמצא האובייקט שרוצים למחוק. אם השדה הזה לא יצוין, הבקשה תחול על הכרטיסייה הראשונה. במסמך שמכיל כרטיסייה אחת:
במסמך שמכיל כמה כרטיסיות:
|
UpdateTableColumnPropertiesRequest
עדכון הערך של TableColumnProperties
של העמודות בטבלה.
ייצוג ב-JSON |
---|
{ "tableStartLocation": { object ( |
שדות | |
---|---|
table
|
המיקום שבו מתחילה הטבלה במסמך. |
column
|
רשימת אינדקסי העמודות שמתחילים באפס, שצריך לעדכן את המאפיין שלהם. אם לא יצוינו אינדקסים, כל העמודות יעודכנו. |
table
|
מאפייני העמודה בטבלה שצריך לעדכן.
אם הערך של |
fields
|
השדות שצריך לעדכן.
צריך לציין שדה אחד לפחות. השורש
לדוגמה, כדי לעדכן את רוחב העמודה, מגדירים את |
UpdateTableCellStyleRequest
עדכון הסגנון של טווח תאים בטבלה.
ייצוג ב-JSON |
---|
{ "tableCellStyle": { object ( |
שדות | |
---|---|
table
|
הסגנון שרוצים להגדיר בתאי הטבלה. כשמעדכנים גבולות, אם תא משותף גבול עם תא סמוך, גם מאפיין הגבול התואם של התא הסמוך מתעדכן. גבולות ממוזגים ואי-נראים לא מתעדכנים. מכיוון שעדכון של גבול שמשותף בין תאים סמוכים באותה בקשה עלול לגרום לעדכוני גבול סותרים, עדכוני גבול חלים בסדר הבא:
|
fields
|
השדות שצריך לעדכן.
צריך לציין שדה אחד לפחות. השורש
לדוגמה, כדי לעדכן את צבע הרקע של תא בטבלה, מגדירים את כדי לאפס נכס לערך ברירת המחדל שלו, צריך לכלול את שם השדה שלו במסיכת השדה, אבל להשאיר את השדה עצמו ללא הגדרה. |
שדה האיחוד
cells . התאים יעודכנו.
cells
יכול להיות רק אחת מהאפשרויות הבאות:
|
|
table
|
טווח הטבלה שמייצג את קבוצת המשנה של הטבלה שאליה חלים העדכונים. |
table
|
המיקום שבו מתחילה הטבלה במסמך. אם מציינים את האפשרות הזו, העדכונים חלים על כל התאים בטבלה. |
TableRange
טווח טבלה מייצג הפניה לקבוצת משנה של טבלה.
חשוב לציין שהתאים שצוינו על ידי טווח טבלה לא יוצרים בהכרח מלבן. לדוגמה, נניח שיש לנו טבלה בגודל 3 x 3 שבה כל התאים בשורה האחרונה מוזגו יחד. הטבלה נראית כך:
[ ][ ][ ]
[ ][ ][ ]
[ ]
טווח טבלה עם מיקום תא בטבלה = (tableStartLocation, row = 0, column = 0), רוחב שורה = 3 ורוחב עמודה = 2 מציין את התאים הבאים:
[ x ][ x ][ ]
[ x ][ x ][ ]
[ x x x ]
ייצוג ב-JSON |
---|
{
"tableCellLocation": {
object ( |
שדות | |
---|---|
table
|
מיקום התא שבו מתחיל טווח הטבלה. |
row
|
היקף השורות של טווח הטבלה. |
column
|
היקף העמודות של טווח הטבלה. |
UpdateTableRowStyleRequest
עדכון TableRowStyle
של השורות בטבלה.
ייצוג ב-JSON |
---|
{ "tableStartLocation": { object ( |
שדות | |
---|---|
table
|
המיקום שבו מתחילה הטבלה במסמך. |
row
|
רשימה של אינדקסים של שורות המבוססים על אפס שיש לעדכן את הסגנון שלהם. אם לא יצוינו אינדקסים, כל השורות יעודכנו. |
table
|
הסגנונות שיוגדרו בשורות. |
fields
|
השדות שצריך לעדכן.
יש לציין שדה אחד לפחות. השורש
לדוגמה, כדי לעדכן את גובה השורה המינימלי, מגדירים את |
ReplaceImageRequest
החלפה של תמונה קיימת בתמונה חדשה.
כשמחליפים תמונה,
חלק מה-image effects
יוסרו מהתמונה הקיימת כדי לשקף את ההתנהגות של עורך Docs.
ייצוג ב-JSON |
---|
{
"imageObjectId": string,
"uri": string,
"imageReplaceMethod": enum ( |
שדות | |
---|---|
image
|
המזהה של התמונה הקיימת שתוחליף. אפשר לאחזר את המזהה מהתגובה של בקשת get. |
uri
|
ה-URI של התמונה החדשה. התמונה מאוחזרת פעם אחת בזמן ההוספה, ועותק שלה נשמר להצגה בתוך המסמך. התמונות צריכות להיות בגודל של עד 50MB, לא יכולות לחרוג מ-25 מגה-פיקסל וצריכות להיות בפורמט PNG, JPEG או GIF.
אורך כתובת ה-URI שצוינה לא יכול לחרוג מ-2KB. ה-URI נשמר עם התמונה וחשוף דרך השדה |
image
|
שיטת ההחלפה. |
tab
|
הכרטיסייה שבה נמצאת התמונה שרוצים להחליף. אם השדה הזה לא יצוין, הבקשה תחול על הכרטיסייה הראשונה. במסמך שמכיל כרטיסייה אחת:
במסמך שמכיל כמה כרטיסיות:
|
ImageReplaceMethod
שיטת החלפת התמונה.
טיפוסים בני מנייה (enum) | |
---|---|
IMAGE_REPLACE_METHOD_UNSPECIFIED
|
שיטת החלפת תמונה לא צוינה. אסור להשתמש בערך הזה. |
CENTER_CROP
|
שינוי גודל התמונה ומרכז אותה כדי למלא את הגבולות של התמונה המקורית. יכול להיות שהתמונה תיחתך כדי למלא את גבולות התמונה המקורית. גודל התמונה לאחר עיבוד יהיה זהה לגודל התמונה המקורית. |
UpdateDocumentStyleRequest
מעדכן את DocumentStyle
.
ייצוג ב-JSON |
---|
{
"documentStyle": {
object ( |
שדות | |
---|---|
document
|
הסגנונות שיוגדרו במסמך.
שינויים מסוימים בסגנון המסמך עשויים לגרום לשינויים אחרים כדי לשקף את ההתנהגות של עורך Docs. למידע נוסף, עיינו במסמכי התיעוד של |
fields
|
השדות שצריך לעדכן.
צריך לציין שדה אחד לפחות. השורש
לדוגמה, כדי לעדכן את הרקע, מגדירים את הערך של |
tab
|
הכרטיסייה שמכילה את הסגנון שרוצים לעדכן. אם לא מציינים את הפרמטר הזה, הבקשה חלה על הכרטיסייה הראשונה. במסמך שמכיל כרטיסייה אחת:
במסמך שמכיל כמה כרטיסיות:
|
MergeTableCellsRequest
מיזוג תאים ב-Table
.
ייצוג ב-JSON |
---|
{
"tableRange": {
object ( |
שדות | |
---|---|
table
|
טווח הטבלה שמציין אילו תאים בטבלה למזג. כל הטקסט בתאים שמוזגו יקושרת ויישמר בתא 'head' של הטווח. זהו התא הימני העליון של הטווח כשכיוון התוכן הוא משמאל לימין, והתא הימני העליון של הטווח במקרים אחרים. אם הטווח לא מרובע (מצב שיכול לקרות במקרים מסוימים שבהם הטווח מכסה תאים שכבר מוזגו או שהטבלה לא מרובע), תוחזר הודעת השגיאה 400 (בקשה לא חוקית). |
UnmergeTableCellsRequest
ביטול המיזוג של תאים ב-Table
.
ייצוג ב-JSON |
---|
{
"tableRange": {
object ( |
שדות | |
---|---|
table
|
טווח הטבלה שמציין אילו תאים בטבלה צריך לבטל את המיזוג שלהם. כל התאים הממוזגים בטווח הזה יבוטלו, ותאים שכבר בוטלו לא יושפעו. אם אין בטווח תאים ממוזגים, הבקשה לא תבצע שום פעולה. אם יש טקסט באחד מהתאים שמוזגו, הטקסט יישאר בתא ה-head בבלוק של התאים שלא מוזגו. התא 'head' הוא התא הימני העליון כשכיוון התוכן הוא משמאל לימין, והתא הימני העליון במקרים אחרים. |
CreateHeaderRequest
יצירת Header
. הכותרת החדשה חלה על SectionStyle
במיקום של SectionBreak
, אם הוא צוין, אחרת היא חלה על DocumentStyle
.
אם כבר קיימת כותרת מהסוג שצוין, תוחזר שגיאה 400 (בקשה לא חוקית).
ייצוג ב-JSON |
---|
{ "type": enum ( |
שדות | |
---|---|
type
|
סוג הכותרת שרוצים ליצור. |
section
|
המיקום של |
CreateFootnoteRequest
הפונקציה יוצרת פלח Footnote
ומוסיפה לו FootnoteReference
חדש במיקום הנתון.
הפלח החדש Footnote
יכיל רווח ואחריו תו של שורה חדשה.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה האיחוד
footnote_reference_location . המיקום שבו רוצים להוסיף את ההפניה להערת השוליים.
footnote_reference_location
יכול להיות רק אחת מהאפשרויות הבאות:
|
|
location
|
מוסיפה את ההפניה להערת שוליים באינדקס ספציפי במסמך.
צריך להוסיף את ההפניה להערת השוליים בתוך גבולות של
אי אפשר להוסיף הפניות להערות שוליים בתוך משוואה, כותרת עליונה, כותרת תחתונה או הערת שוליים. מכיוון שאפשר להוסיף הפניות להערות שוליים רק בגוף, השדה |
end
|
הוספת ההפניה להערת השוליים בסוף גוף המסמך.
אי אפשר להוסיף הפניות להערות שוליים בתוך כותרת עליונה, כותרת תחתונה או הערת שוליים. מכיוון שאפשר להוסיף הפניות להערות שוליים רק בגוף המאמר, השדה |
ReplaceNamedRangeContentRequest
החלפת התוכן של NamedRange
או NamedRanges
שצוינו בתוכן החלופי שצוין.
חשוב לזכור ש-NamedRange
יכול לכלול כמה ranges
לא רציפים. במקרה כזה, רק התוכן בטווח הראשון יוחלף. שאר הטווחים והתוכן שלהם יימחקו.
במקרים שבהם החלפה או מחיקה של טווחים כלשהם תוביל למבנה מסמך לא תקין, תוחזר שגיאה מסוג 400 (בקשה לא חוקית).
ייצוג ב-JSON |
---|
{ "tabsCriteria": { object ( |
שדות | |
---|---|
tabs
|
זה שינוי אופציונלי. הקריטריונים שמשמשים לציון באילו כרטיסיות מתבצעת ההחלפה. אם לא מציינים את הפרמטר הזה, ההחלפה תחול על כל הכרטיסיות. במסמך שמכיל כרטיסייה אחת:
במסמך שמכיל כמה כרטיסיות:
|
שדה האיחוד
replacement_content . התוכן שבו רוצים להחליף את התוכן הקיים של טווח השמות.
replacement_content
יכול להיות רק אחת מהאפשרויות הבאות:
|
|
text
|
החלפת התוכן של טווחי השמות שצוינו בטקסט הנתון. |
שדה האיחוד
named_range_reference . הפניה לטווח התאים בעל השם שתוכנו יוחלף.
named_range_reference יכול להיות רק אחת מהאפשרויות הבאות:
|
|
named
|
המזהה של טווח התאים בעל השם שהתוכן שלו יוחלף. אם אין טווח בעל שם עם המזהה שצוין, תוחזר שגיאה 400 (בקשה לא חוקית). |
named
|
השם של
אם יש כמה |
UpdateSectionStyleRequest
מעדכן את SectionStyle
.
ייצוג ב-JSON |
---|
{ "range": { object ( |
שדות | |
---|---|
range
|
הטווח שחופף לקטעים שרוצים לעצב.
מכיוון שאפשר להוסיף מעברי קטע רק לגוף, השדה |
section
|
הסגנונות שייקבעו בקטע.
אם תבצעו שינויים מסוימים בסגנון של קטע, יכול להיות ששינויים אחרים ישקפו את ההתנהגות של עורך Docs. למידע נוסף, עיינו במסמכי התיעוד של |
fields
|
השדות שצריך לעדכן.
צריך לציין שדה אחד לפחות. הערך הבסיסי (root)
לדוגמה, כדי לעדכן את השוליים השמאליים, מגדירים את |
InsertSectionBreakRequest
הוספת מעבר בין קטעים במיקום הרצוי.
תו של שורה חדשה יופיע לפני מעבר הקטע.
ייצוג JSON |
---|
{ "sectionType": enum ( |
שדות | |
---|---|
section
|
סוג הקטע שרוצים להוסיף. |
שדה האיחוד
insertion_location . המיקום שבו יתווסף ההפסקה.
insertion_location יכול להיות רק אחת מהאפשרויות הבאות:
|
|
location
|
הוספת שורה חדשה ופסק קטע במקום ספציפי במסמך.
צריך להוסיף את הפסקת הקטע בתוך גבולות של
אי אפשר להוסיף חלוקות לקטעים בתוך טבלה, נוסחה, הערת שוליים, כותרת או כותרת תחתונה. מכיוון שאפשר להוסיף מעברי קטע רק לגוף, השדה |
end
|
הוספת שורה חדשה וקטע חדש בסוף גוף המסמך.
אי אפשר להוסיף חלוקות לקטעים בתוך הערה שוליים, כותרת עליונה או כותרת תחתונה. מכיוון שאפשר להוסיף חלוקות לקטעים רק בגוף, השדה |
DeleteHeaderRequest
מחיקה של Header
מהמסמך.
ייצוג ב-JSON |
---|
{ "headerId": string, "tabId": string } |
שדות | |
---|---|
header
|
המזהה של הכותרת שרוצים למחוק. אם הכותרת הזו מוגדרת ב- |
tab
|
הכרטיסייה שמכילה את הכותרת שרוצים למחוק. אם השדה הזה לא יצוין, הבקשה תחול על הכרטיסייה הראשונה. במסמך שמכיל כרטיסייה אחת:
במסמך שמכיל כמה כרטיסיות:
|
PinTableHeaderRowsRequest
עדכון מספר שורות הכותרת המוצמדות בטבלה.
ייצוג ב-JSON |
---|
{
"tableStartLocation": {
object ( |
שדות | |
---|---|
table
|
המיקום שבו הטבלה מתחילה במסמך. |
pinned
|
מספר השורות בטבלה להצמדה, כאשר 0 מרמז על כך שכל השורות לא מוצמדות. |