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

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