Method: projects.locations.collections.dataConnector.startConnectorRun

Avvia un processo di sincronizzazione immediata per un DataConnector. Gli utenti del connettore di terze parti devono specificare quali entità devono essere sincronizzate. I connettori FHIR devono fornire un timestamp per indicare il momento a partire dal quale devono essere sincronizzati i dati.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Nome del connettore nel formato projects/{project}/locations/{location}/collections/ {collectionId}/dataConnector

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "entities": [
    string
  ],
  "healthcareFhirResourceTypes": [
    string
  ],
  "forceRefreshContent": boolean,
  "syncIdentity": boolean,
  "syncSinceTimestamp": string
}
Campi
entities[]

string

Specifica quali entità del connettore di terze parti devono essere sincronizzate. Se non specificato, verranno sincronizzate tutte le entità.
healthcareFhirResourceTypes[]

string

I tipi di risorse FHIR da importare. I tipi di risorse devono essere un sottoinsieme di tutti i tipi di risorse FHIR supportati. Se è vuoto, vengono utilizzati per impostazione predefinita tutti i tipi di risorse FHIR supportati.
forceRefreshContent

boolean

Facoltativo. Indica se forzare l'aggiornamento dei contenuti non strutturati dei documenti.

Se impostato su true, la parte dei contenuti dei documenti verrà aggiornata indipendentemente dallo stato di aggiornamento dei contenuti di riferimento.
syncIdentity

boolean

Se il valore è true, attiva la sincronizzazione delle identità.
syncSinceTimestamp

string (Timestamp format)

timestamp per indicare il punto nel tempo da cui devono essere sincronizzati i dati per i connettori di dati di streaming/batch. Questo campo viene utilizzato solo per i connettori sanitari.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di ConnectorRun.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta Authentication Overview.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa parent:

  • discoveryengine.dataConnectors.startConnectorRun

Per saperne di più, consulta la documentazione di IAM.