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 הוא EXACT.

metadataLocation

object (DeveloperMetadataLocation)

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

locationMatchingStrategy

enum (DeveloperMetadataLocationMatchingStrategy)

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