REST Resource: indexing.datasources.items

Resource: Item

Merepresentasikan satu objek yang merupakan item dalam indeks penelusuran, seperti file, folder, atau data database.

Representasi JSON 
{
  "name": string,
  "acl": {
    object (ItemAcl)
  },
  "metadata": {
    object (ItemMetadata)
  },
  "structuredData": {
    object (ItemStructuredData)
  },
  "content": {
    object (ItemContent)
  },
  "version": string,
  "status": {
    object (ItemStatus)
  },
  "queue": string,
  "payload": string,
  "itemType": enum (Item.ItemType)
}
Kolom
name

string

Nama Item. Format: datasources/{sourceId}/items/{itemId}

Bidang ini harus diisi. Panjang maksimumnya adalah 1.536 karakter.
acl

object (ItemAcl)

Daftar kontrol akses untuk item ini.
metadata

object (ItemMetadata)

Informasi metadata.
structuredData

object (ItemStructuredData)

Data terstruktur untuk item yang harus sesuai dengan definisi objek terdaftar dalam skema untuk sumber data.
content

object (ItemContent)

Konten item yang akan diindeks dan teksnya dapat ditelusuri.
version

string (bytes format)

Wajib. Sistem pengindeksan menyimpan versi dari sumber data sebagai string byte dan membandingkan versi Item dalam indeks dengan versi Item yang diantrekan menggunakan pengurutan leksikografis.

Pengindeksan Cloud Search 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 kolom ini adalah 1024 byte.

Untuk informasi tentang pengaruh versi item terhadap proses penghapusan, lihat Menangani revisi setelah penghapusan manual.

String berenkode base64.
status

object (ItemStatus)

Status item. Kolom khusus output.
queue

string

Antrean yang berisi item ini. Panjang maksimumnya adalah 100 karakter.
payload

string (bytes format)

Konektor status tambahan dapat menyimpan untuk item ini. Panjang maksimum adalah 10.000 byte.

String berenkode base64.
itemType

enum (Item.ItemType)

Jenis untuk item ini.

ItemAcl

Informasi daftar kontrol akses untuk item. Untuk informasi selengkapnya, lihat ACL Peta.

Representasi JSON 
{
  "inheritAclFrom": string,
  "aclInheritanceType": enum (ItemAcl.AclInheritanceType),
  "readers": [
    {
      object (Principal)
    }
  ],
  "deniedReaders": [
    {
      object (Principal)
    }
  ],
  "owners": [
    {
      object (Principal)
    }
  ]
}
Kolom
inheritAclFrom

string

Nama item yang akan mewarisi Daftar Izin Akses (ACL). Catatan: Pewarisan ACL hanya memberikan izin akses ke item turunan dan tidak menentukan hubungan struktural, atau tidak memberikan cara yang mudah untuk menghapus grup item yang besar. Menghapus induk ACL dari indeks hanya akan mengubah izin akses item turunan yang mereferensikan induk di kolom inheritAclFrom. Item masih ada dalam indeks, tetapi mungkin tidak terlihat di hasil penelusuran. Sebaliknya, penghapusan item penampung juga akan menghapus semua item yang mereferensikan penampung melalui kolom containerName. Panjang maksimum untuk kolom ini adalah 1.536 karakter.
aclInheritanceType

enum (ItemAcl.AclInheritanceType)

Menetapkan jenis aturan akses yang akan diterapkan saat item mewarisi ACL-nya dari induk. Kolom ini harus selalu ditetapkan bersama dengan kolom inheritAclFrom. Selain itu, saat kolom inheritAclFrom ditetapkan, kolom ini harus ditetapkan ke AclInheritanceType yang valid.
readers[]

object (Principal)

Daftar akun utama yang diizinkan untuk melihat item di hasil penelusuran. Opsional jika mewarisi izin dari item lain atau jika item tidak dimaksudkan untuk terlihat, seperti virtual containers. Jumlah maksimum elemen adalah 1.000.
deniedReaders[]

object (Principal)

Daftar akun utama yang secara eksplisit ditolak aksesnya ke item di hasil penelusuran. Meskipun akun utama ditolak aksesnya secara default, gunakan pembaca yang ditolak untuk menangani pengecualian dan mengganti daftar pembaca yang diizinkan. Jumlah maksimum elemen adalah 100.
owners[]

object (Principal)

Opsional. Daftar pemilik untuk item. Kolom ini tidak memengaruhi izin akses dokumen. Namun, hal ini menawarkan sedikit peningkatan peringkat pada item jika pengguna yang membuat kueri adalah pemiliknya. Jumlah maksimum elemen adalah 5.

ItemAcl.AclInheritanceType

Jenis pewarisan ACL.

Enum
NOT_APPLICABLE Nilai default saat item ini tidak mewarisi ACL. Gunakan NOT_APPLICABLE jika inheritAclFrom kosong. Item tanpa pewarisan ACL masih dapat memiliki ACL yang disediakan oleh kolom readers dan deniedReaders-nya sendiri.
CHILD_OVERRIDE Selama konflik otorisasi, ACL item turunan menentukan akses bacanya.
PARENT_OVERRIDE Selama konflik otorisasi, ACL item induk yang ditentukan di kolom inheritAclFrom akan menentukan akses baca.
BOTH_PERMIT Akses hanya diberikan jika item ini dan item induk yang ditentukan di kolom inheritAclFrom mengizinkan akses baca.

Akun utama

Referensi ke pengguna, grup, atau domain.

Representasi JSON 
{

  // Union field principal can be only one of the following:
  "gsuitePrincipal": {
    object (GSuitePrincipal)
  },
  "userResourceName": string,
  "groupResourceName": string
  // End of list of possible types for union field principal.
}
Kolom

Kolom union principal.

principal hanya dapat berupa salah satu dari hal berikut:
gsuitePrincipal

object (GSuitePrincipal)

Akun utama ini adalah pengguna, grup, atau domain Google Workspace.
userResourceName

string

Entitas utama ini adalah pengguna yang diidentifikasi menggunakan identitas eksternal. Kolom nama harus menentukan nama resource pengguna dengan format ini: identitysources/{sourceId}/users/{ID}
groupResourceName

string

Entitas utama ini adalah grup yang diidentifikasi menggunakan identitas eksternal. Kolom nama harus menentukan nama resource grup dengan format ini: identitysources/{sourceId}/groups/{ID}

ItemMetadata

Kolom metadata yang tersedia untuk item.

Representasi JSON 
{
  "title": string,
  "sourceRepositoryUrl": string,
  "containerName": string,
  "objectType": string,
  "createTime": string,
  "updateTime": string,
  "interactions": [
    {
      object (Interaction)
    }
  ],
  "contentLanguage": string,
  "mimeType": string,
  "searchQualityMetadata": {
    object (SearchQualityMetadata)
  },
  "keywords": [
    string
  ],
  "hash": string,
  "contextAttributes": [
    {
      object (ContextAttribute)
    }
  ]
}
Kolom
title

string

Judul item. Jika diberikan, ini akan menjadi judul yang ditampilkan dari hasil query.search. Panjang maksimumnya adalah 2048 karakter.
sourceRepositoryUrl

string

Menautkan ke repositori sumber yang menayangkan data. Hasil penelusuran akan menerapkan link ini ke judul. Spasi kosong atau karakter khusus dapat menyebabkan link hasil Cloud Search memicu pemberitahuan pengalihan; untuk menghindarinya, encode URL. Panjang maksimumnya adalah 2048 karakter.
containerName

string

Nama penampung untuk item ini. Penghapusan item penampung akan menyebabkan penghapusan item ini secara otomatis. Catatan: ACL tidak diwarisi dari item penampung. Untuk memberikan pewarisan ACL untuk item, gunakan kolom inheritAclFrom. Panjang maksimumnya adalah 1.536 karakter.
objectType

string

Jenis item. Nama ini harus sesuai dengan nama definisi objek dalam skema yang terdaftar untuk sumber data. Misalnya, jika skema untuk sumber data berisi definisi objek dengan nama 'dokumen', permintaan pengindeksan item untuk objek jenis tersebut harus menetapkan objectType ke 'dokumen'. Panjang maksimumnya adalah 256 karakter.
createTime

string (Timestamp format)

Waktu saat item dibuat di repositori sumber.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Waktu saat item terakhir diubah di repositori sumber.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
interactions[]

object (Interaction)

Daftar interaksi untuk item. Interaksi digunakan untuk meningkatkan kualitas query.search, tetapi tidak ditampilkan kepada pengguna akhir. Jumlah maksimum elemen adalah 1.000.
contentLanguage

string

Kode bahasa BCP-47 untuk item, seperti "en-US" atau "sr-Latn". Untuk informasi selengkapnya, lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Panjang maksimum adalah 32 karakter.
mimeType

string

Jenis mime asli ItemContent.content di repositori sumber. Panjang maksimumnya adalah 256 karakter.
searchQualityMetadata

object (SearchQualityMetadata)

Metadata kualitas penelusuran tambahan item
keywords[]

string

Kata kunci atau frasa tambahan yang harus cocok dengan item. Digunakan secara internal untuk konten buatan pengguna. Jumlah maksimum elemen adalah 100. Panjang maksimumnya adalah 8.192 karakter.
hash

string

Nilai hashing yang disediakan oleh pemanggil API. Ini dapat digunakan dengan metode items.push untuk menghitung status yang diubah. Panjang maksimumnya adalah 2048 karakter.
contextAttributes[]

object (ContextAttribute)

Kumpulan atribut bernama yang terkait dengan item. Hal ini dapat digunakan untuk memengaruhi peringkat item berdasarkan konteks dalam permintaan. Jumlah maksimum elemen adalah 10.

Interaksi

Merepresentasikan interaksi antara pengguna dan item.

Representasi JSON 
{
  "type": enum (Interaction.InteractionType),
  "principal": {
    object (Principal)
  },
  "interactionTime": string
}
Kolom
type

enum (Interaction.InteractionType)
principal

object (Principal)

Pengguna yang menindaklanjuti item.
interactionTime

string (Timestamp format)

Waktu saat pengguna melakukan tindakan pada item. Jika ada beberapa tindakan dengan jenis yang sama untuk satu pengguna, hanya tindakan terbaru yang dicatat.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

Interaction.InteractionType

Jenis aktivitas yang dilakukan pengguna pada item.

Enum
UNSPECIFIED Nilai tidak valid.
VIEW Interaksi ini menunjukkan bahwa pengguna telah melihat item.
EDIT Interaksi ini menunjukkan bahwa pengguna telah mengedit item.

SearchQualityMetadata

Metadata kualitas penelusuran tambahan item.

Representasi JSON 
{
  "quality": number
}
Kolom
quality

number

Indikasi kualitas item, yang digunakan untuk memengaruhi kualitas penelusuran. Nilai harus antara 0,0 (kualitas terendah) dan 1,0 (kualitas tertinggi). Nilai defaultnya adalah 0,0.

ContextAttribute

Atribut bernama yang terkait dengan item yang dapat digunakan untuk memengaruhi peringkat item berdasarkan konteks dalam permintaan.

Representasi JSON 
{
  "name": string,
  "values": [
    string
  ]
}
Kolom
name

string

Nama atribut. Kolom ini tidak boleh kosong. Panjang maksimum adalah 32 karakter. Nama harus diawali dengan huruf dan hanya boleh berisi huruf (A-Z, a-z) atau angka (0-9). Nama akan dinormalisasi (huruf kecil) sebelum dicocokkan.
values[]

string

Nilai teks atribut. Jumlah maksimum elemen adalah 10. Panjang maksimum elemen dalam array adalah 32 karakter. Nilai akan dinormalisasi (huruf kecil) sebelum dicocokkan.

ItemStructuredData

Kolom data terstruktur yang tersedia untuk item.

Representasi JSON 
{
  "object": {
    object (StructuredDataObject)
  },
  "hash": string
}
Kolom
object

object (StructuredDataObject)

Objek data terstruktur yang harus sesuai dengan definisi objek terdaftar dalam skema untuk sumber data.
hash

string

Nilai hashing yang disediakan oleh pemanggil API. Ini dapat digunakan dengan metode items.push untuk menghitung status yang diubah. Panjang maksimumnya adalah 2048 karakter.

StructuredDataObject

Objek data terstruktur yang terdiri dari properti bernama.

Representasi JSON 
{
  "properties": [
    {
      object (NamedProperty)
    }
  ]
}
Kolom
properties[]

object (NamedProperty)

Properti untuk objek. Jumlah maksimum elemen adalah 1.000.

NamedProperty

Pasangan nama-nilai berjenis untuk data terstruktur. Jenis nilai harus sama dengan jenis yang terdaftar untuk properti name dalam definisi objek objectType.

Representasi JSON 
{
  "name": string,

  // Union field value can be only one of the following:
  "integerValues": {
    object (NamedProperty.IntegerValues)
  },
  "doubleValues": {
    object (NamedProperty.DoubleValues)
  },
  "timestampValues": {
    object (NamedProperty.TimestampValues)
  },
  "booleanValue": boolean,
  "objectValues": {
    object (NamedProperty.ObjectValues)
  },
  "enumValues": {
    object (NamedProperty.EnumValues)
  },
  "dateValues": {
    object (NamedProperty.DateValues)
  },
  "textValues": {
    object (NamedProperty.TextValues)
  },
  "htmlValues": {
    object (NamedProperty.HtmlValues)
  }
  // End of list of possible types for union field value.
}
Kolom
name

string

Nama properti. Nama ini harus sesuai dengan nama properti yang terdaftar untuk definisi objek dalam skema. Panjang maksimum yang diizinkan untuk properti ini adalah 256 karakter.
Kolom union value. Nilai properti yang dinamai. Perhatikan bahwa properti hanya dapat menyimpan nilai dari satu jenis. value hanya dapat berupa salah satu dari berikut:
integerValues

object (NamedProperty.IntegerValues)
doubleValues

object (NamedProperty.DoubleValues)
timestampValues

object (NamedProperty.TimestampValues)
booleanValue

boolean
objectValues

object (NamedProperty.ObjectValues)
enumValues

object (NamedProperty.EnumValues)
dateValues

object (NamedProperty.DateValues)
textValues

object (NamedProperty.TextValues)
htmlValues

object (NamedProperty.HtmlValues)

NamedProperty.IntegerValues

Daftar nilai bilangan bulat.

Representasi JSON 
{
  "values": [
    string
  ]
}
Kolom
values[]

string (int64 format)

NamedProperty.DoubleValues

Daftar nilai ganda.

Representasi JSON 
{
  "values": [
    number
  ]
}
Kolom
values[]

number

NamedProperty.TimestampValues

Daftar nilai stempel waktu.

Representasi JSON 
{
  "values": [
    string
  ]
}
Kolom
values[]

string (Timestamp format)

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

NamedProperty.ObjectValues

Daftar nilai objek.

Representasi JSON 
{
  "values": [
    {
      object (StructuredDataObject)
    }
  ]
}
Kolom
values[]

object (StructuredDataObject)

NamedProperty.EnumValues

Daftar nilai enum.

Representasi JSON 
{
  "values": [
    string
  ]
}
Kolom
values[]

string

Panjang maksimum yang diizinkan untuk nilai string adalah 32 karakter.

NamedProperty.DateValues

Daftar nilai tanggal.

Representasi JSON 
{
  "values": [
    {
      object (Date)
    }
  ]
}
Kolom
values[]

object (Date)

NamedProperty.TextValues

Daftar nilai teks.

Representasi JSON 
{
  "values": [
    string
  ]
}
Kolom
values[]

string

Panjang maksimum yang diizinkan untuk nilai teks adalah 2048 karakter.

NamedProperty.HtmlValues

Daftar nilai html.

Representasi JSON 
{
  "values": [
    string
  ]
}
Kolom
values[]

string

Panjang maksimum yang diizinkan untuk nilai html adalah 2048 karakter.

ItemContent

Konten item yang akan diindeks dan ditampilkan oleh Cloud Search. Hanya string berenkode UTF-8 yang diizinkan sebagai inlineContent. Jika konten diupload dan bukan biner, konten tersebut harus berenkode UTF-8.

Representasi JSON 
{
  "contentFormat": enum (ItemContent.ContentFormat),
  "hash": string,

  // Union field content can be only one of the following:
  "inlineContent": string,
  "contentDataRef": {
    object (UploadItemRef)
  }
  // End of list of possible types for union field content.
}
Kolom
contentFormat

enum (ItemContent.ContentFormat)
hash

string

Info hashing yang dihitung dan diberikan oleh klien API untuk konten. Dapat digunakan dengan metode items.push untuk menghitung status yang diubah. Panjang maksimumnya adalah 2048 karakter.

Kolom union content.

content hanya dapat berupa salah satu dari hal berikut:
inlineContent

string (bytes format)

Konten yang disediakan inline dalam metode update. Panjang maksimum adalah 102400 byte (100 KiB).

String berenkode base64.
contentDataRef

object (UploadItemRef)

Upload ID referensi konten yang diupload sebelumnya melalui metode tulis.

ItemContent.ContentFormat

Format konten. Jika formatnya RAW, konten harus dalam format yang ditentukan oleh mimeType.

Enum
UNSPECIFIED Nilai tidak valid.
HTML contentFormat adalah HTML.
TEXT contentFormat adalah teks bebas.
RAW contentFormat adalah byte mentah.

UploadItemRef

Mewakili referensi sesi upload. Referensi ini dibuat melalui upload method. Referensi ini berlaku selama 30 hari setelah dibuat. Pembaruan konten item dapat merujuk ke konten yang diupload ini melalui contentDataRef.

Representasi JSON 
{
  "name": string
}
Kolom
name

string

Nama referensi konten. Panjang maksimumnya adalah 2048 karakter.

ItemStatus

Ini berisi status item dan error apa pun.

Representasi JSON 
{
  "code": enum (ItemStatus.Code),
  "processingErrors": [
    {
      object (ProcessingError)
    }
  ],
  "repositoryErrors": [
    {
      object (RepositoryError)
    }
  ]
}
Kolom
code

enum (ItemStatus.Code)

Kode status.
processingErrors[]

object (ProcessingError)

Detail error jika item dalam status ERROR.
repositoryErrors[]

object (RepositoryError)

Error repositori dilaporkan oleh konektor.

ProcessingError

Representasi JSON 
{
  "code": enum (ProcessingErrorCode),
  "errorMessage": string,
  "fieldViolations": [
    {
      object (FieldViolation)
    }
  ]
}
Kolom
code

enum (ProcessingErrorCode)

Kode error yang menunjukkan sifat error.
errorMessage

string

Deskripsi error.
fieldViolations[]

object (FieldViolation)

Jika kolom item tidak valid, kolom ini berisi detail tentang error validasi.

ProcessingErrorCode

Kode untuk menunjukkan error yang terjadi selama pemrosesan item oleh server Cloud Search. Satu item dapat berisi beberapa error pemrosesan.

Enum
PROCESSING_ERROR_CODE_UNSPECIFIED Nilai hanya input. Gunakan nilai ini di Item.
MALFORMED_REQUEST ACL, metadata, atau konten item salah format atau dalam status tidak valid. FieldViolations berisi detail selengkapnya tentang lokasi masalah.
UNSUPPORTED_CONTENT_FORMAT Format konten tidak didukung.
INDIRECT_BROKEN_ACL Item dengan informasi ACL yang tidak lengkap karena mewarisi item lain dengan ACL yang rusak atau memiliki grup dengan turunan yang tidak dipetakan.
ACL_CYCLE Grafik pewarisan ACL membentuk siklus.

FieldViolation

Representasi JSON 
{
  "field": string,
  "description": string
}
Kolom
field

string

Jalur kolom dengan pelanggaran.
description

string

Deskripsi error.

RepositoryError

Error saat konektor berkomunikasi dengan repositori sumber.

Representasi JSON 
{
  "type": enum (RepositoryError.Type),
  "httpStatusCode": integer,
  "errorMessage": string
}
Kolom
type

enum (RepositoryError.Type)

Jenis error.
httpStatusCode

integer

Kode error. Cocok dengan definisi kode status HTTP.
errorMessage

string

Pesan yang menjelaskan error. Panjang maksimum pesan yang diizinkan adalah 8.192 karakter.

RepositoryError.Type

Daftar kode error untuk masalah komunikasi dengan repositori.

Enum
UNKNOWN Error tidak diketahui.
NETWORK_ERROR Host tidak diketahui atau tidak dapat dijangkau.
DNS_ERROR Masalah DNS, seperti server DNS tidak merespons.
CONNECTION_ERROR Tidak dapat terhubung ke server repositori.
AUTHENTICATION_ERROR Autentikasi gagal karena kredensial salah.
AUTHORIZATION_ERROR Akun layanan tidak diberi otorisasi untuk repositori.
SERVER_ERROR Error server repositori.
QUOTA_EXCEEDED Kuota terlampaui.
SERVICE_UNAVAILABLE Server untuk sementara tidak tersedia.
CLIENT_ERROR Error terkait klien, seperti permintaan yang tidak valid dari konektor ke server repositori.

Item.ItemType

Enum
UNSPECIFIED
CONTENT_ITEM Item yang diindeks hanya untuk tujuan menayangkan informasi. Item ini tidak dapat dirujuk di kolom containerName atau inheritAclFrom.
CONTAINER_ITEM Item yang diindeks dan tujuannya adalah menyediakan ACL untuk item lain dan/atau berisi item lain.
VIRTUAL_CONTAINER_ITEM Item yang tidak diindeks, tetapi memiliki tujuan yang sama dengan CONTAINER_ITEM.

Metode

delete

 Menghapus Item resource untuk nama resource yang ditentukan.

deleteQueueItems

 Menghapus semua item dalam antrean.

get

 Mendapatkan Item resource berdasarkan nama item.

index

 Memperbarui ACL, metadata, dan konten Item.

list

 Mencantumkan semua atau sebagian Item resources.

poll

 Melakukan polling untuk item yang belum dipesan dari antrean pengindeksan dan menandai kumpulan sebagai dipesan, dimulai dengan item yang memiliki stempel waktu terlama dari ItemStatus prioritas tertinggi.

push

 Mendorong item ke antrean untuk polling dan update berikutnya.

unreserve

 Membatalkan reservasi semua item dari antrean, sehingga semua item memenuhi syarat untuk di-polling.

upload

 Membuat sesi upload untuk mengupload konten item.