comment envoyer les données collectées, quels sont les paramètres - OpenSearch

Envoie un lot d'enregistrements de comportement utilisateur ou d'attributs vers une collection de données dans une application OpenSearch.

Syntaxe de la requête

POST /v3/openapi/app-groups/{appName}/data-collections/{dataCollectionName}/data-collection-type/{dataCollectionType}/actions/bulk

Paramètres de chemin

Paramètre	Description
`appName`	Nom de l'application OpenSearch.
`dataCollectionName`	Nom de la collection de données. Par défaut, il correspond au nom de l'application OpenSearch.
`dataCollectionType`	Type de données à envoyer. Valeurs valides : `USER`, `ITEM_INFO`, `BEHAVIOR`, `INDUSTRY_SPECIFIC`.

L'endpoint et les paramètres d'en-tête de requête sont omis de l'URL ci-dessus. Pour la structure complète de la requête, consultez Structure de la requête.

Corps de la requête

Le corps de la requête est un tableau JSON transmis en tant que valeur du paramètre docs.

Paramètre	Type	Obligatoire	Description
`docs`	Liste	Oui	Liste des documents à envoyer.

Chaque objet document de la liste docs contient les paramètres suivants.

Paramètre	Type	Obligatoire	Description
`cmd`	String	Oui	Opération à effectuer. Définissez la valeur sur `ADD`.
`fields`	Map	Oui	Champs du document. Le schéma des champs doit correspondre au type de table cible.

Paramètre fields

La valeur fields est une map clé-valeur dont les clés doivent correspondre au schéma de la table cible. OpenSearch prend en charge trois types de tables : les tables utilisateur, les tables d'éléments et les tables de comportement. Pour les définitions de champs de chaque type de table, consultez Collection de données 2.0.

Éléments de réponse

Paramètre	Type	Description
`errors`	Liste	Détails de l'erreur.
`status`	String	Résultat de la requête. Valeurs valides : `OK` (réussie), `FAIL` (échouée). En cas d'échec de la requête, résolvez les erreurs en fonction du code d'erreur.
`request_id`	String	ID de la requête.
`result`	Boolean	Renvoie `true` pour les requêtes réussies. Non renvoyé pour les requêtes ayant échoué.

Exemples

Requête

POST /v3/openapi/app-groups/zhao_special/data-collections/zhao_special/data-collection-type/behavior/actions/bulk

[
  {
    "cmd": "ADD",
    "fields": {
        "sdk_type": "opensearch_sdk",
        "sdk_version": "3.2.0",
        "user_id": "10469628",
        "biz_id": 123,
        "trace_id": "231084198510103333",
        "item_id": "id",
        "item_type": "item",
        "bhv_type": "click",
        "reach_time": "20190730105931"
    }
  }
]

Réponse

{
    "errors": [],
    "request_id": "155084740119723291017595",
    "status": "OK",
    "result": true
}