- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme Kapsamları
- IndexItemOptions
- Deneyin.
Item
ACL'sini, meta verilerini ve içeriğini günceller. Mevcut değilse Item
eklenir. Bu yöntem kısmi güncellemeleri desteklemez. Değer sağlanmayan alanlar Cloud Search dizininden silinir.
Bu API'nin çalıştırılması için bir yönetici veya hizmet hesabı gerekir. Kullanılan hizmet hesabı, ilgili veri kaynağında beyaz listeye eklenen hesaptır.
HTTP isteği
POST https://cloudsearch.googleapis.com/v1/indexing/{item.name=datasources/*/items/*}:index
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
item.name |
Öğenin adı. Biçim: datasources/{sourceId}/items/{itemId} Bu alanının doldurulması zorunludur. Maksimum uzunluk 1.536 karakterdir. |
İstek içeriği
İstek metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{ "item": { "name": string, "acl": { "inheritAclFrom": string, "aclInheritanceType": enum ( |
Alanlar | |
---|---|
item.acl |
Bu öğenin erişim kontrol listesi. |
item.metadata |
Meta veri bilgileri. |
item.structuredData |
Öğenin, veri kaynağının şemasında kayıtlı bir nesne tanımına uygun olması gereken yapılandırılmış verileri. |
item.content |
Dizine eklenecek ve metin olarak aranabilir hale getirilecek öğe içeriği. |
item.version |
Zorunlu. Dizine ekleme sistemi, veri kaynağındaki sürümü bir bayt dizesi olarak depolar ve dizinindeki öğe sürümünü, söz dizimi sıralamasını kullanarak sıraya eklenen öğenin sürümüyle karşılaştırır. Cloud Search dizine ekleme, sürüm değeri şu anda dizine eklenen öğenin sürümünden küçük veya bu sürüme eşit olan ve sıraya eklenen öğeleri dizine eklemez veya silmez. Bu alanın maksimum uzunluğu 1.024 bayttır. Öğe sürümünün silme işlemini nasıl etkilediği hakkında bilgi edinmek için Manuel silme işleminden sonra düzeltmeleri işleme başlıklı makaleyi inceleyin. Base64 kodlu bir dize. |
item.status |
Öğenin durumu. Yalnızca çıkış alanı. |
item.queue |
Bu öğenin ait olduğu sıra. Maksimum uzunluk 100 karakterdir. |
item.payload |
Ek durum bağlayıcısı bu öğe için depolama alanı sağlayabilir. Maksimum uzunluk 10.000 bayttır. Base64 kodlu bir dize. |
item.itemType |
Bu öğenin türü. |
connectorName |
Bu çağrıyı yapan bağlayıcının adı. Biçim: datasources/{sourceId}/connectors/{ID} |
mode |
Zorunlu. Bu istek için RequestMode. |
debugOptions |
Sık kullanılan hata ayıklama seçenekleri. |
indexItemOptions |
|
Yanıt gövdesi
Başarılıysa yanıt metni, Operation
öğesinin bir örneğini içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/cloud_search.indexing
https://www.googleapis.com/auth/cloud_search
Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.
IndexItemOptions
JSON gösterimi |
---|
{ "allowUnknownGsuitePrincipals": boolean } |
Alanlar | |
---|---|
allowUnknownGsuitePrincipals |
Dizin isteği için var olmayan veya silinmiş Google Workspace kimliklerine izin verilip verilmeyeceğini belirtir. |