Method: indexing.datasources.items.poll

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:

ERROR

MODIFIED

NEW_ITEM

ACCEPTED

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

string

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 (ItemStatus.Code)
  ],
  "limit": integer,
  "queue": string,
  "debugOptions": {
    object (DebugOptions)
  }
}
Champs
connectorName

string

Nom du connecteur effectuant cet appel.

Format: datasources/{sourceId}/connectors/{ID}

statusCodes[]

enum (ItemStatus.Code)

Limitez les éléments interrogés à ceux associés à ces états.

limit

integer

Nombre maximal d'éléments à renvoyer.

La valeur maximale est 100 et la valeur par défaut est 20.

queue

string

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

object (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 (Item)
    }
  ]
}
Champs
items[]

object (Item)

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:

version

metadata.hash

structuredData.hash

content.hash

payload

status

queue

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.