Alan maskeleri

Alan maskeleri, API çağrılarını yapanların bir isteğin döndürmesi gereken alanları listelemesinin bir yoludur. Alan maskesi kullanmak, API'nin gereksiz çalışmalardan kaçınmasını ve performansı artırmasını sağlar.

Alan maskesi, URL sorgu parametresi veya HTTP ya da gRPC başlığı olarak belirtilebilir:

URL Sorgu Parametresi	HTTP veya gRPC Başlığı
$fields veya fields	X-Goog-FieldMask

Alan maskesi söz dizimi

Aşağıdaki alan maskesi örnekleri, bu örnek yanıt türüne dayalıdır.

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;
}

İç içe yerleştirilmiş alanlar, nokta söz dizimi kullanılarak veya parantez içine alınarak seçilebilir.

İfade	Çıkış
*	Tüm alanları ve iç içe geçmiş alanları döndürür.
field1,field2	field1 ve field2 değerinin iç içe yerleştirilmiş tüm alanlarını döndürür.
field1,field2.foo1	field1 ve field2.foo1 değerlerini döndürür.
field1,field2(foo1)	field1 ve field2.foo1 değerlerini döndürür.
field1,field2(foo1,foo2)	İade sayısı: field1 field2.foo1 field2.foo2
field1,field2(foo1,foo3(bar1,bar2))	İade sayısı: field1 field2.foo1 field2.foo3.bar1 field2.foo3.bar2