Method: projects.locations.collections.dataConnector.startConnectorRun

Memulai proses sinkronisasi langsung untuk DataConnector. Pengguna Konektor Pihak Ketiga harus menentukan entitas mana yang harus disinkronkan. FHIR Connector harus memberikan stempel waktu untuk menunjukkan titik waktu mulai dari data yang 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. Nama konektor dalam bentuk 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 entity Konektor Pihak Ketiga yang harus disinkronkan. Jika tidak ditentukan, semua entity akan disinkronkan.
healthcareFhirResourceTypes[]

string

Jenis resource FHIR yang akan diimpor. Jenis resource harus berupa subset dari semua jenis resource FHIR yang didukung. Secara default, semua jenis resource FHIR yang didukung jika kosong.
forceRefreshContent

boolean

Opsional. Apakah akan memuat ulang konten tidak terstruktur dokumen secara paksa.

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

boolean

Jika benar (true), picu Sinkronisasi identitas.
syncSinceTimestamp

string (Timestamp format)

stempel waktu untuk menunjukkan titik waktu dari mana data harus disinkronkan untuk Konektor data Streaming/Batch. Kolom ini hanya digunakan untuk Healthcare Connector.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi 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 berisi instance ConnectorRun.

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.assist.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.