Method: projects.locations.collections.dataConnector.startConnectorRun

Memulai proses sinkronisasi langsung untuk DataConnector. Pengguna Konektor Pihak Ketiga harus menentukan entitas mana yang akan disinkronkan. Konektor FHIR harus memberikan stempel waktu untuk menunjukkan titik waktu mulai data harus disinkronkan.

Permintaan HTTP

POST https://discoveryengine.googleapis.com/v1alpha/{parent=projects/*/locations/*/collections/*/dataConnector}:startConnectorRun

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib diisi. Nama konektor dalam format projects/{project}/locations/{location}/collections/{collectionId}/dataConnector

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "entities": [
    string
  ],
  "healthcareFhirResourceTypes": [
    string
  ],
  "forceRefreshContent": boolean,
  "syncIdentity": boolean,
  "syncSinceTimestamp": string
}
Kolom
entities[]

string

Menentukan entitas Konektor Pihak Ketiga mana yang akan disinkronkan. Jika tidak ditentukan, semua entitas akan disinkronkan.
healthcareFhirResourceTypes[]

string

Jenis resource FHIR yang akan diimpor. Jenis resource harus merupakan subset dari semua jenis resource FHIR yang didukung. Jika kosong, jenis resource FHIR yang didukung akan ditetapkan secara default.
forceRefreshContent

boolean

Opsional. Apakah akan memaksa pembaruan konten tidak terstruktur dokumen.

Jika ditetapkan ke true, bagian konten dokumen akan diperbarui, terlepas dari status pembaruan konten yang direferensikan.
syncIdentity

boolean

Jika benar (true), picu sinkronisasi Identitas.
syncSinceTimestamp

string (Timestamp format)

Stempel waktu untuk menunjukkan titik waktu mulai data harus disinkronkan untuk Konektor data Streaming/Batch. Kolom ini hanya digunakan untuk Konektor Healthcare.

Menggunakan RFC 3339 yang outputnya akan selalu dikonversi ke format Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

Isi respons

Jika berhasil, isi respons akan memuat instance ConnectorRun.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite
  • 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.dataConnectors.startConnectorRun

Untuk mengetahui informasi selengkapnya, lihat dokumentasi IAM.