משאב: DeveloperMetadata
מטא-נתונים של מפתח שמשויכים למיקום או לאובייקט בגיליון אלקטרוני. אפשר להשתמש במטא-נתונים של המפתח כדי לשייך נתונים שרירותיים לחלקים שונים בגיליון האלקטרוני. הנתונים האלה יישארו משויכים למיקומים האלה בזמן שהם עוברים ממקום למקום בגיליון האלקטרוני ועורכים אותו. לדוגמה, אם המטא-נתונים של המפתח משויכים לשורה 5, ואחר כך נוספת שורה נוספת מעל לשורה 5, המטא-נתונים המקוריים עדיין ישויכו לשורה שאליה הם שויכו (מה שמופיע עכשיו בשורה 6). אם האובייקט המשויך נמחק, גם המטא-נתונים שלו נמחקים.
ייצוג JSON |
---|
{ "metadataId": integer, "metadataKey": string, "metadataValue": string, "location": { object ( |
שדות | |
---|---|
metadataId |
המזהה הייחודי ברמת הגיליון האלקטרוני שמשמש לזיהוי המטא-נתונים. אפשר לציין מזהים כשיוצרים מטא-נתונים, אחרת הם ייווצרו באופן אקראי ויוקצה. חייב להיות חיובי. |
metadataKey |
מפתח של מטא-נתונים. גיליון אלקטרוני יכול לכלול כמה מטא-נתונים עם אותו מפתח. במטא-נתונים של המפתח תמיד צריך לציין מפתח. |
metadataValue |
נתונים שמשויכים למפתח של המטא-נתונים. |
location |
המיקום שאליו משויכים המטא-נתונים. |
visibility |
הרשאות הגישה של המטא-נתונים. למטא-נתונים של המפתח תמיד צריכה להיות הרשאת גישה מוגדרת. |
DeveloperMetadataLocation
מיקום שאליו ניתן לשייך מטא-נתונים בגיליון אלקטרוני.
ייצוג JSON |
---|
{ "locationType": enum ( |
שדות | |
---|---|
locationType |
סוג המיקום שהאובייקט הזה מייצג. השדה הזה הוא לקריאה בלבד. |
שדה איחוד location . המיקום שאליו משויכים המטא-נתונים. location יכול להיות רק אחת מהאפשרויות הבאות: |
|
spreadsheet |
הערך הוא True כשמטא-נתונים משויכים לגיליון אלקטרוני שלם. |
sheetId |
מזהה הגיליון כשהמטא-נתונים משויכים לגיליון שלם. |
dimensionRange |
מייצג את השורה או העמודה כשהמטא-נתונים משויכים למאפיין. הערך שצוין בשדה |
DeveloperMetadataLocationType
ספירה של סוגי המיקומים שאליהם יכולים להיות משויכים מטא-נתונים של מפתחים.
טיפוסים בני מנייה (enum) | |
---|---|
DEVELOPER_METADATA_LOCATION_TYPE_UNSPECIFIED |
ערך ברירת המחדל. |
ROW |
מטא-נתונים של מפתח שמשויכים למאפיין שורה שלם. |
COLUMN |
מטא-נתונים של מפתח שמשויכים למאפיין של כל העמודה. |
SHEET |
מטא-נתונים של מפתח שמשויכים לגיליון שלם. |
SPREADSHEET |
מטא-נתונים של המפתח שמשויכים לכל הגיליון האלקטרוני. |
DeveloperMetadataVisibility
ספירה של חשיפות אפשריות של מטא-נתונים.
טיפוסים בני מנייה (enum) | |
---|---|
DEVELOPER_METADATA_VISIBILITY_UNSPECIFIED |
ערך ברירת המחדל. |
DOCUMENT |
מטא-נתונים שגלויים במסמך נגישים מכל פרויקט פיתוח עם גישה למסמך. |
PROJECT |
מטא-נתונים שגלויים לפרויקט גלויים רק לפרויקט המפתח שיצר את המטא-נתונים, ונגישים להם. |
שיטות |
|
---|---|
|
הפונקציה מחזירה את המטא-נתונים של המפתח עם המזהה שצוין. |
|
הפונקציה מחזירה את כל המטא-נתונים של המפתח שתואמים לערך שצוין בשדה DataFilter . |