Method: spreadsheets.developerMetadata.search

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

בקשת HTTP

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/developerMetadata:search

כתובת ה-URL כוללת תחביר של קידוד gRPC.

פרמטרים של נתיב

פרמטרים
spreadsheetId

string

המזהה של הגיליון האלקטרוני שממנו יש לאחזר את המטא-נתונים.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
שדות
dataFilters[]

object (DataFilter)

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

גוף התשובה

תשובה לבקשה לחיפוש מטא-נתונים של מפתח.

אם התגובה הצליחה, גוף התגובה מכיל נתונים עם המבנה הבא:

ייצוג JSON
{
  "matchedDeveloperMetadata": [
    {
      object (MatchedDeveloperMetadata)
    }
  ]
}
שדות
matchedDeveloperMetadata[]

object (MatchedDeveloperMetadata)

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

היקפי הרשאה

מחייב אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

למידע נוסף, ניתן לעיין במדריך ההרשאה.

מטא-נתונים של MATCHDeveloperMetadata

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

ייצוג JSON
{
  "developerMetadata": {
    object (DeveloperMetadata)
  },
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
שדות
developerMetadata

object (DeveloperMetadata)

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

dataFilters[]

object (DataFilter)

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