- Permintaan HTTP
- Parameter lokasi
- Isi permintaan
- Isi respons
- Cakupan Otorisasi
- IndexItemOptions
- Cobalah!
Memperbarui ACL, metadata, dan konten Item
. Ini akan menyisipkan Item
jika tidak ada. Metode ini tidak mendukung update parsial. Kolom tanpa nilai yang diberikan akan dihapus dari indeks Cloud Search.
API ini memerlukan admin atau akun layanan agar dapat dieksekusi. Akun layanan yang digunakan adalah akun yang diizinkan di sumber data yang sesuai.
Permintaan HTTP
POST https://cloudsearch.googleapis.com/v1/indexing/{item.name=datasources/*/items/*}:index
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
item.name |
Nama Item. Format: sumber data/{sourceId}/items/{itemId} Bidang ini harus diisi. Panjang maksimum adalah 1.536 karakter. |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "item": { "name": string, "acl": { "inheritAclFrom": string, "aclInheritanceType": enum ( |
Kolom | |
---|---|
item.acl |
Daftar kontrol akses untuk item ini. |
item.metadata |
Informasi metadata. |
item.structuredData |
Data terstruktur untuk item yang harus sesuai dengan definisi objek yang terdaftar dalam skema untuk sumber data. |
item.content |
Konten item yang akan diindeks dan membuat teks dapat ditelusuri. |
item.version |
Wajib. Sistem pengindeksan menyimpan versi dari sumber data sebagai string byte dan membandingkan versi Item dalam indeks dengan versi Item dalam antrean menggunakan pengurutan leksikal. Cloud Search Indexing tidak akan mengindeks atau menghapus item dalam antrean dengan nilai versi yang kurang dari atau sama dengan versi item yang saat ini diindeks. Panjang maksimum untuk kolom ini adalah 1024 byte. Untuk mengetahui informasi tentang pengaruh versi item terhadap proses penghapusan, lihat Menangani revisi setelah penghapusan manual. String berenkode base64. |
item.status |
Status item. Kolom khusus output. |
item.queue |
Masukkan item ini ke dalam antrean. Panjang maksimum adalah 100 karakter. |
item.payload |
Konektor status tambahan dapat menyimpan untuk item ini. Panjang maksimum adalah 10.000 byte. String berenkode base64. |
item.itemType |
Jenis untuk item ini. |
connectorName |
Nama konektor yang melakukan panggilan ini. Format: datasources/{sourceId}/connectors/{ID} |
mode |
Wajib. RequestMode untuk permintaan ini. |
debugOptions |
Opsi debug umum. |
indexItemOptions |
|
Isi respons
Jika berhasil, isi respons akan berisi instance Operation
.
Cakupan Otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/cloud_search.indexing
https://www.googleapis.com/auth/cloud_search
Untuk informasi selengkapnya, lihat Panduan otorisasi.
IndexItemOptions
Representasi JSON |
---|
{ "allowUnknownGsuitePrincipals": boolean } |
Kolom | |
---|---|
allowUnknownGsuitePrincipals |
Menentukan apakah permintaan indeks harus mengizinkan akun utama Google Workspace yang tidak ada atau telah dihapus. |