REST Resource: indexing.datasources.items

{
  "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)
}

string

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

Bidang ini harus diisi. Panjang maksimum adalah 1.536 karakter.

object (ItemAcl)

Daftar kontrol akses untuk item ini.

object (ItemMetadata)

Informasi metadata.

object (ItemStructuredData)

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

object (ItemContent)

Konten item yang akan diindeks dan teksnya dapat ditelusuri.

string (bytes format)

Wajib diisi. 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 kolom ini adalah 1.024 byte.

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

String berenkode base64.

object (ItemStatus)

Status item. Kolom hanya output.

string

Antrean untuk item ini. Panjang maksimum adalah 100 karakter.

string (bytes format)

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

String berenkode base64.

enum (Item.ItemType)

Jenis untuk item ini.

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

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, juga tidak memberikan cara mudah untuk menghapus kelompok item dalam jumlah besar. Menghapus induk ACL dari indeks hanya akan mengubah izin akses item turunan yang mereferensikan induk di kolom inheritAclFrom. Item tersebut masih ada dalam indeks, tetapi mungkin tidak terlihat di hasil penelusuran. Sebaliknya, penghapusan item penampung juga akan menghapus semua item yang merujuk penampung melalui kolom containerName. Panjang maksimum kolom ini adalah 1.536 karakter.

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, jika kolom inheritAclFrom ditetapkan, kolom ini harus ditetapkan ke AclInheritanceType yang valid.

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 elemen maksimum adalah 1.000.

object (Principal)

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

object (Principal)

Opsional. Daftar pemilik item. Kolom ini tidak berpengaruh pada izin akses dokumen. Namun, hal ini menawarkan sedikit menaikkan peringkat item di mana pengguna yang mengajukan kueri adalah pemilik. Jumlah elemen maksimum adalah 5.

{

  // 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.
}

object (GSuitePrincipal)

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

string

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

string

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

{
  "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)
    }
  ]
}

string

Judul item. Jika diberikan, kolom ini akan menjadi judul yang ditampilkan dari hasil query.search. Panjang maksimum adalah 2.048 karakter.

string

Link ke repositori sumber yang menayangkan data. Hasil penelusuran menerapkan link ini ke judul. Spasi kosong atau karakter khusus dapat menyebabkan link hasil Cloud Seach memicu pemberitahuan pengalihan; Untuk menghindarinya, enkode URL tersebut. Panjang maksimum adalah 2.048 karakter.

string

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

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 'document', permintaan pengindeksan item untuk objek dari jenis tersebut harus menetapkan objectType ke 'document'. Panjang maksimum adalah 256 karakter.

string (Timestamp format)

Waktu saat item dibuat di repositori sumber.

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

string (Timestamp format)

Waktu saat item terakhir diubah di repositori sumber.

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

object (Interaction)

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

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.

string

Jenis mime asli ItemContent.content dalam repositori sumber. Panjang maksimum adalah 256 karakter.

object (SearchQualityMetadata)

Metadata kualitas penelusuran tambahan untuk item

string

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

string

Nilai hashing yang diberikan oleh pemanggil API. Ini dapat digunakan dengan metode items.push untuk menghitung status yang diubah. Panjang maksimum adalah 2.048 karakter.

object (ContextAttribute)

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

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

enum (Interaction.InteractionType)

object (Principal)

Pengguna yang menindaklanjuti item.

string (Timestamp format)

Waktu saat pengguna menindaklanjuti item. Jika ada beberapa tindakan dari jenis yang sama untuk satu pengguna, hanya tindakan terbaru yang akan dicatat.

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

{
  "quality": number
}

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.

{
  "name": string,
  "values": [
    string
  ]
}

string

Nama atribut. Wajib diisi. Panjang maksimum adalah 32 karakter. Nama harus diawali dengan huruf dan hanya berisi huruf (A-Z, a-z) atau angka (0-9). Nama akan dinormalkan (huruf kecil) sebelum dicocokkan.

string

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

{
  "object": {
    object (StructuredDataObject)
  },
  "hash": string
}

object (StructuredDataObject)

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

string

Nilai hashing yang diberikan oleh pemanggil API. Ini dapat digunakan dengan metode items.push untuk menghitung status yang diubah. Panjang maksimum adalah 2.048 karakter.

{
  "properties": [
    {
      object (NamedProperty)
    }
  ]
}

object (NamedProperty)

Properti untuk objek. Jumlah elemen maksimum adalah 1.000.

{
  "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.
}

string

Nama properti. Nama ini harus sesuai dengan nama properti yang didaftarkan untuk definisi objek dalam skema. Panjang maksimum yang diizinkan untuk properti ini adalah 256 karakter.

object (NamedProperty.IntegerValues)

object (NamedProperty.DoubleValues)

object (NamedProperty.TimestampValues)

boolean

object (NamedProperty.ObjectValues)

object (NamedProperty.EnumValues)

object (NamedProperty.DateValues)

object (NamedProperty.TextValues)

object (NamedProperty.HtmlValues)

{
  "values": [
    string
  ]
}

string (int64 format)

{
  "values": [
    number
  ]
}

number

{
  "values": [
    string
  ]
}

string (Timestamp format)

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

{
  "values": [
    {
      object (StructuredDataObject)
    }
  ]
}

object (StructuredDataObject)

{
  "values": [
    string
  ]
}

string

Panjang maksimum yang diizinkan untuk nilai string adalah 32 karakter.

{
  "values": [
    {
      object (Date)
    }
  ]
}

object (Date)

{
  "values": [
    string
  ]
}

string

Panjang maksimum yang diizinkan untuk nilai teks adalah 2.048 karakter.

{
  "values": [
    string
  ]
}

string

Panjang maksimum yang diizinkan untuk nilai HTML adalah 2.048 karakter.

{
  "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.
}

enum (ItemContent.ContentFormat)

string

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

string (bytes format)

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

String berenkode base64.

object (UploadItemRef)

Upload ID referensi konten yang diupload sebelumnya melalui metode tulis.

{
  "name": string
}

string

Nama referensi konten. Panjang maksimum adalah 2.048 karakter.

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

enum (ItemStatus.Code)

Kode status.

object (ProcessingError)

Detail error jika item dalam status ERROR.

object (RepositoryError)

Error repositori dilaporkan oleh konektor.

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

enum (ProcessingErrorCode)

Kode error yang menunjukkan sifat error.

string

Deskripsi error.

object (FieldViolation)

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

{
  "field": string,
  "description": string
}

string

Jalur kolom dengan pelanggaran.

string

Deskripsi error.

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

enum (RepositoryError.Type)

Jenis error.

integer

Kode error. Cocok dengan definisi kode status HTTP.

string

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