フィールド マスク

フィールド マスクは、API 呼び出し元がリクエストで返すフィールドを一覧表示する方法です。フィールド マスクを使用すると、API で不要な作業を回避してパフォーマンスを向上させることができます。

フィールド マスクは、URL クエリ パラメータまたは HTTP ヘッダーや gRPC ヘッダーとして指定できます。

URL クエリ パラメータ	HTTP または gRPC ヘッダー
$fields または fields	X-Goog-FieldMask

フィールド マスクの構文

次のフィールド マスクの例は、このレスポンスの型に基づいています。

message ExampleResponse {
  message Foo {
    string foo1 = 1;
    string foo2 = 2;
    Bar foo3 = 3;
  }

  message Bar {
    string bar1 = 1;
    string bar2 = 2;
    string bar3 = 3;
  }

  string field1 = 1;
  repeated Foo field2 = 2;
}

ネストされたフィールドは、ドット構文を使用するか、かっこで囲むことで選択できます。

式	出力
*	すべてのフィールドとネストされたフィールドを返します。
field1,field2	field1 と field2 のすべてのネストされたフィールドを返します。
field1,field2.foo1	field1 と field2.foo1 を返します。
field1,field2(foo1)	field1 と field2.foo1 を返します。
field1,field2(foo1,foo2)	戻り値: field1 field2.foo1 field2.foo2
field1,field2(foo1,foo3(bar1,bar2))	戻り値: field1 field2.foo1 field2.foo3.bar1 field2.foo3.bar2