- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Essayer
Interroge les éléments non réservés de la file d'attente d'indexation et marque un ensemble comme réservé, en commençant par les éléments dont l'horodatage le plus ancien est associé à la priorité ItemStatus
la plus élevée. L'ordre de priorité est le suivant:
En réservant des éléments, vous évitez que des sondages provenant d'autres fils de discussion génèrent des ensembles qui se chevauchent.
Après avoir traité les éléments réservés, le client doit rétablir l'état non réservé de certains éléments, soit en appelant index,
, soit en appelant push
avec le type REQUEUE.
.
Les éléments deviennent automatiquement disponibles (non réservés) au bout de quatre heures, même si aucune méthode de mise à jour ou d'envoi n'est appelée.
L'exécution de cette API nécessite un compte administrateur ou de service. Le compte de service utilisé est celui qui figure sur la liste blanche de la source de données correspondante.
Requête HTTP
POST https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*}/items:poll
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
name |
Nom de la source de données vers laquelle les éléments sont interrogés. Format: datasources/{sourceId} |
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{ "connectorName": string, "statusCodes": [ enum ( |
Champs | |
---|---|
connectorName |
Nom du connecteur effectuant cet appel. Format: datasources/{sourceId}/connectors/{ID} |
statusCodes[] |
Limitez les éléments interrogés à ceux associés à ces états. |
limit |
Nombre maximal d'éléments à renvoyer. La valeur maximale est 100 et la valeur par défaut est 20. |
queue |
Nom de la file d'attente dans laquelle extraire des éléments. Si aucune valeur n'est spécifiée, items.poll sera récupéré dans la file d'attente "default". La longueur ne doit pas dépasser 100 caractères. |
debugOptions |
Options de débogage courantes |
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient des données présentant la structure suivante :
Représentation JSON |
---|
{
"items": [
{
object ( |
Champs | |
---|---|
items[] |
Ensemble d'éléments de la file d'attente que le connecteur peut traiter. Le sous-ensemble de champs suivant est renseigné pour ces éléments: |
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/cloud_search.indexing
https://www.googleapis.com/auth/cloud_search
Pour en savoir plus, consultez le guide relatif aux autorisations.