Platform API Google menyediakan serangkaian fungsi umum untuk semua API Google yang dibuat menggunakan platform tersebut. Untuk menggunakan dan mengontrol fungsi tersebut, platform menentukan kumpulan parameter permintaan khusus yang disebut parameter sistem. Parameter ini tersedia di semua Google REST API dan gRPC API. Parameter sistem dapat ditentukan menggunakan parameter kueri HTTP atau header HTTP. Untuk Google gRPC API, hanya header HTTP yang didukung.
Sebagian besar pengguna tidak perlu menggunakan parameter ini secara langsung. Namun, library klien ini sering digunakan oleh library klien yang disediakan Google. Jika Anda perlu menulis kode kustom untuk mengakses Google API secara langsung, parameter sistem dapat berguna dalam kasus seperti mengontrol pencetakan JSON yang rapi atau menentukan Kunci API.
Pemetaan HTTP
Untuk permintaan HTTP, parameter sistem dikirim sebagai parameter kueri URL atau
header permintaan HTTP. Misalnya, jika Anda memiliki parameter sistem $foo, parameter tersebut
akan dikirim sebagai ?$foo=xxx di URL, atau ?%24foo=xxx jika dienkode URL. Lihat
tabel di bawah untuk mengetahui detailnya.
Pemetaan gRPC
Untuk permintaan gRPC, parameter sistem dikirim sebagai header permintaan HTTP dengan kunci dalam huruf kecil. Lihat tabel di bawah untuk mengetahui detailnya.
Definisi
Tabel berikut mencantumkan semua parameter sistem dan definisinya.
| Parameter Kueri URL | Header HTTP/gRPC | Deskripsi |
|---|---|---|
Authorization |
Kredensial autentikasi. Lihat Ringkasan autentikasi untuk mengetahui detailnya. | |
$alt,alt |
Format respons alternatif. Nilai yang didukung adalah json (default), media, proto, sse (streaming JSON). |
|
$.xgafv |
Format error JSON. Nilai yang didukung adalah 1, 2 (default). Format error 1 hanya boleh digunakan oleh Library Klien Google API. |
|
$callback,callback |
Parameter callback JSONP. | |
$ct |
Content-Type |
Penggantian header permintaan Content-Type HTTP. |
$fields,fields |
X-Goog-FieldMask |
FieldMask digunakan untuk pemfilteran respons. Jika kosong, semua kolom harus ditampilkan, kecuali jika didokumentasikan sebaliknya. |
X-HTTP-Method-Override |
Metode HTTP yang dimaksudkan untuk permintaan. Beberapa proxy jaringan tidak menerima semua metode HTTP. | |
$key,key |
X-Goog-Api-Key |
Kunci Google API. Lihat https://cloud.google.com/docs/authentication/api-keys untuk mengetahui detailnya. |
passwd,password |
Digunakan untuk mencegah penempatan sandi di URL. | |
$prettyPrint,prettyPrint |
Menampilkan respons JSON dengan format yang lebih baik. Nilai yang didukung adalah true (default), false. |
|
quotaUser |
X-Goog-Quota-User |
ID pengguna pseudo untuk menagih kuota per pengguna. Jika tidak ditentukan, akun utama yang diautentikasi akan digunakan. Jika tidak ada akun utama yang diautentikasi, alamat IP klien akan digunakan. Jika ditentukan, kunci API yang valid dengan batasan layanan harus digunakan untuk mengidentifikasi project kuota. Jika tidak, parameter ini akan diabaikan. |
$outputDefaults |
Memaksa untuk menampilkan nilai default proto untuk respons JSON. | |
$unique |
Parameter kueri unik untuk menonaktifkan cache permintaan. | |
X-Goog-Api-Client |
Identifikasi klien API. Nilainya adalah daftar string NAME "/" SEMVER yang dipisahkan spasi, dengan NAME hanya boleh berisi huruf kecil, angka, dan "-", dan SEMVER harus berupa string versi semantik. Misalnya: X-Goog-Api-Client: python/3.5.0 grpc-google-pubsub-v1/0.1.0-beta2 linux/2.7.0. |
|
X-Goog-Request-Reason |
Berisi alasan untuk membuat permintaan, yang dimaksudkan untuk dicatat dalam logging audit. Contoh alasannya adalah nomor tiket kasus dukungan. | |
$userProject |
X-Goog-User-Project |
Project yang ditentukan pemanggil untuk tujuan kuota dan penagihan. Pemanggil harus memiliki izin serviceusage.services.use di project. |
X-Server-Timeout |
Waktu tunggu (dalam detik, nilai float) agar server selesai memproses permintaan. Parameter sistem ini hanya berlaku untuk REST API yang waktu tunggu sisi kliennya tidak berlaku. | |
x-goog-request-params |
Meneruskan parameter tambahan untuk permintaan gRPC dalam format kueri URL. Misalnya: x-goog-request-params: service=pubsub.googleapis.com&release=2021-11-01r0. |
Log Perubahan
- 11-2021 Memublikasikan dokumentasi untuk
x-goog-request-params. - 02-2021 Memublikasikan dokumentasi untuk
quotaUser. - 07-2020 Parameter kueri OAuth 2.0 yang tidak digunakan lagi.
- 10-2019 Memperkenalkan parameter sistem
X-Server-Timeout. - 10-2017 Memperkenalkan parameter sistem
X-Goog-User-Project.