דף זה תורגם על ידי Cloud Translation API.

DataFilter

ייצוג ב-JSON
DeveloperMetadataLookup
- ייצוג ב-JSON
DeveloperMetadataLocationMatchingStrategy

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

ייצוג ב-JSON

ייצוג ב-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`. }

{

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

ייצוג ב-JSON

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

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