Method: projects.locations.dataStores.branches.documents.create

Membuat Document.

Permintaan HTTP

POST https://discoveryengine.googleapis.com/v1beta/{parent=projects/*/locations/*/dataStores/*/branches/*}/documents

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Nama resource induk, seperti projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}.

Parameter kueri

Parameter
documentId

string

Wajib. ID yang akan digunakan untuk Document, yang menjadi komponen akhir Document.name.

Jika pemanggil tidak memiliki izin untuk membuat Document, terlepas dari apakah Document tersebut ada atau tidak, error PERMISSION_DENIED akan ditampilkan.

Kolom ini harus unik di antara semua Document dengan parent yang sama. Jika tidak, error ALREADY_EXISTS akan ditampilkan.

Kolom ini harus sesuai dengan standar RFC-1034 dengan batas panjang 128 karakter. Jika tidak, error INVALID_ARGUMENT akan ditampilkan.

Isi permintaan

Isi permintaan memuat instance Document.

Isi respons

Jika berhasil, isi respons akan memuat instance Document yang baru dibuat.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

Izin IAM

Memerlukan izin IAM berikut pada resource parent:

  • discoveryengine.documents.create

Untuk mengetahui informasi selengkapnya, lihat dokumentasi IAM.