DataFilter

מסנן שמתאר אילו נתונים צריך לבחור או להחזיר מבקשה.

ייצוג JSON 
{

  // Union field filter can be only one of the following:
  "developerMetadataLookup": {
    object (DeveloperMetadataLookup)
  },
  "a1Range": string,
  "gridRange": {
    object (GridRange)
  }
  // End of list of possible types for union field filter.
}
שדות
שדה איחוד filter. סוגי המסננים שעשויים להגביל את הנתונים שנבחרו. filter יכול להיות רק אחת מהאפשרויות הבאות:
developerMetadataLookup

object (DeveloperMetadataLookup)

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

string

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

object (GridRange)

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

DeveloperMetadataLookup

הפונקציה בוחרת את העמודה 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 מצוין כמיקום שלא מוגדר בגיליון אלקטרוני: המטא-נתונים של הגיליון האלקטרוני לא יכולים להצליב מיקום אחר של מטא-נתונים של המפתח. בנוסף, אין לציין את השדה הזה כאשר השדה locationMatchingStrategy מצוין כ-מדויקת.
metadataLocation

object (DeveloperMetadataLocation)

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

enum (DeveloperMetadataLocationMatchingStrategy)

קביעת ההתאמה של החיפוש הזה למיקום. אם השדה הזה מוגדר כ'מדויקת', מתבצעת התאמה רק למטא-נתונים של המפתח שמשויכים למיקום המדויק שצוין. אם השדה הזה מוגדר כ'תוכן אינטראקטיבי', גם המטא-נתונים של המפתח שמשויכים למיקומים מצטלבים תואמים. אם לא צוין ערך, הערך בשדה הזה יהיה 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 מציין שהמיקום שצוין צריך להתאים למיקום המדויק הזה וכן לכל המיקומים שמצטלבים. לדוגמה, אם שורה שלישית צוינה כמיקום, שיטת ההתאמה הזו תתאים למטא-נתונים של מפתח שמשויכים לשורה שלישית ולמטא-נתונים שמשויכים למיקומים שחוצים את שורה שלוש. אם למשל היו מטא-נתונים של מפתח שמשויכים לעמודה B, שיטת ההתאמה הזו תתאים גם למיקום הזה, כי עמודה ב' חוצה את שורה שלוש.