DataFilter

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

ייצוג ב-JSON 
{

  "developerMetadataLookup": {
    object (DeveloperMetadataLookup)
  },
  "a1Range": string,
  "gridRange": {
    object (GridRange)
  }
}
שדות
שדה איחוד filter. סוגי המסננים שעשויים להגביל את הנתונים שנבחרו. הערך filter יכול להיות רק אחד מהבאים:
developerMetadataLookup

object (DeveloperMetadataLookup)

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

string

בחירת נתונים שתואמים לטווח A1 שצוין.
gridRange

object (GridRange)

בחירת נתונים שתואמים לטווח שמתואר על ידי GridRange.

DeveloperMetadataLookup

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

ייצוג ב-JSON 
{
  "locationType": enum (DeveloperMetadataLocationType),
  "metadataLocation": {
    object (DeveloperMetadataLocation)
  },
  "locationMatchingStrategy": enum (DeveloperMetadataLocationMatchingStrategy),
  "metadataId": integer,
  "metadataKey": string,
  "metadataValue": string,
  "visibility": enum (DeveloperMetadataVisibility)
}
שדות
locationType

enum (DeveloperMetadataLocationType)

מגביל את המטא נתונים למפתחים שנבחרו לאותם רשומות שמשויכות למיקומים מהסוג שצוין. לדוגמה, אם השדה הזה מוגדר כ-ROW, החיפוש הזה יתייחס רק למטא נתונים למפתחים שמשויכים לשורות. אם לא מציינים את השדה, נלקחים בחשבון כל סוגי המיקומים. אי אפשר לציין את השדה הזה כ-SPREADSHEET כשמציינים את locationMatchingStrategy כ-INTERSECTING או כשמציינים את metadataLocation כמיקום שאינו גיליון אלקטרוני. מטא נתונים של גיליון אלקטרוני לא יכולים לחפוף למיקום אחר של מטא נתונים למפתחים. אם מציינים את הערך EXACT בשדה locationMatchingStrategy, צריך להשאיר את השדה הזה לא מוגדר.
metadataLocation

object (DeveloperMetadataLocation)

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

enum (DeveloperMetadataLocationMatchingStrategy)

קובע את מידת ההתאמה של החיפוש למיקום. אם השדה הזה מוגדר כ-EXACT, מתבצעת התאמה רק למטא נתונים של מפתחים שמשויכים למיקום המדויק שצוין. אם השדה הזה מצוין כ-INTERSECTING, גם מטא נתונים למפתחים שמשויכים למיקומים מצטלבים יותאמו. אם לא מציינים ערך בשדה הזה, ערך ברירת המחדל שלו הוא INTERSECTING. אם מציינים את השדה הזה, צריך לציין גם metadataLocation.
metadataId

integer

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

string

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

string

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

enum (DeveloperMetadataVisibility)

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

DeveloperMetadataLocationMatchingStrategy

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

טיפוסים בני מנייה (enum)
DEVELOPER_METADATA_LOCATION_MATCHING_STRATEGY_UNSPECIFIED ערך ברירת המחדל. אסור להשתמש בערך הזה.
EXACT_LOCATION מציין שצריך להתאים בדיוק למיקום שצוין. לדוגמה, אם שורה שלוש צוינה כמיקום, אסטרטגיית ההתאמה הזו תתאים רק למטא נתונים של מפתחים שמשויכים גם לשורה שלוש. המערכת לא תביא בחשבון מטא נתונים שמשויכים למיקומים אחרים.
INTERSECTING_LOCATION מציין שמיקום מסוים צריך להיות זהה למיקום המדויק הזה, וגם לכל מיקום אחר שחופף לו. לדוגמה, אם שורה שלוש צוינה כמיקום, אסטרטגיית ההתאמה הזו תתאים למטא-נתונים של מפתח שמשויכים לשורה שלוש, וגם למטא-נתונים שמשויכים למיקומים שחופפים לשורה שלוש. לדוגמה, אם יש מטא נתונים של מפתח שמשויכים לעמודה ב', אסטרטגיית ההתאמה הזו תתאים גם למיקום הזה כי עמודה ב' מצטלבת עם שורה שלוש.