REST Resource: spreadsheets.developerMetadata

משאב: DeveloperMetadata

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

ייצוג JSON 
{
  "metadataId": integer,
  "metadataKey": string,
  "metadataValue": string,
  "location": {
    object (DeveloperMetadataLocation)
  },
  "visibility": enum (DeveloperMetadataVisibility)
}
שדות
metadataId

integer

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

string

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

string

נתונים שמשויכים למפתח של המטא-נתונים.
location

object (DeveloperMetadataLocation)

המיקום שאליו משויכים המטא-נתונים.
visibility

enum (DeveloperMetadataVisibility)

הרשאות הגישה של המטא-נתונים. למטא-נתונים של המפתח תמיד צריכה להיות הרשאת גישה מוגדרת.

DeveloperMetadataLocation

מיקום שאליו ניתן לשייך מטא-נתונים בגיליון אלקטרוני.

ייצוג JSON 
{
  "locationType": enum (DeveloperMetadataLocationType),

  // Union field location can be only one of the following:
  "spreadsheet": boolean,
  "sheetId": integer,
  "dimensionRange": {
    object (DimensionRange)
  }
  // End of list of possible types for union field location.
}
שדות
locationType

enum (DeveloperMetadataLocationType)

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

boolean

הערך הוא True כשמטא-נתונים משויכים לגיליון אלקטרוני שלם.
sheetId

integer

מזהה הגיליון כשהמטא-נתונים משויכים לגיליון שלם.
dimensionRange

object (DimensionRange)

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

DeveloperMetadataLocationType

ספירה של סוגי המיקומים שאליהם יכולים להיות משויכים מטא-נתונים של מפתחים.

טיפוסים בני מנייה (enum)
DEVELOPER_METADATA_LOCATION_TYPE_UNSPECIFIED ערך ברירת המחדל.
ROW מטא-נתונים של מפתח שמשויכים למאפיין שורה שלם.
COLUMN מטא-נתונים של מפתח שמשויכים למאפיין של כל העמודה.
SHEET מטא-נתונים של מפתח שמשויכים לגיליון שלם.
SPREADSHEET מטא-נתונים של המפתח שמשויכים לכל הגיליון האלקטרוני.

DeveloperMetadataVisibility

ספירה של חשיפות אפשריות של מטא-נתונים.

טיפוסים בני מנייה (enum)
DEVELOPER_METADATA_VISIBILITY_UNSPECIFIED ערך ברירת המחדל.
DOCUMENT מטא-נתונים שגלויים במסמך נגישים מכל פרויקט פיתוח עם גישה למסמך.
PROJECT מטא-נתונים שגלויים לפרויקט גלויים רק לפרויקט המפתח שיצר את המטא-נתונים, ונגישים להם.

שיטות

get

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