Method: providers.tasks.search

Eingestellt: Verwende stattdessen taskTrackingInfo.get.

HTTP-Anfrage

GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks:search

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Muss das Format providers/{provider} haben. Der Anbieter muss die Google Cloud-Projekt-ID sein. Beispiel: sample-cloud-project.

Suchparameter

Parameter
header

object (DeliveryRequestHeader)

Optional. Der Standard-Anfrageheader der Delivery API.
trackingId

string

Erforderlich. Die ID des Satzes zusammengehöriger Aufgaben, die angefordert werden. Tracking-IDs unterliegen den folgenden Einschränkungen:

  • Muss ein gültiger Unicode-String sein.
  • Er ist auf maximal 64 Zeichen begrenzt.
  • Normalisiert nach der Unicode-Normalisierungsform C.
  • Darf keine der folgenden ASCII-Zeichen enthalten: '/', ':', '?', , oder '#'.
pageSize

integer

Optional. Die maximale Anzahl von Aufgaben, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn Sie diesen Wert nicht angeben, bestimmt der Server die Anzahl der zurückzugebenden Ergebnisse.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen tasks.search-Aufruf empfangen wurde. Sie müssen diesen Wert angeben, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für tasks.search bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Die tasks.search-Antwort. Sie enthält die Aufgaben, die den Suchkriterien in SearchTasksRequest entsprechen.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "tasks": [
    {
      object (Task)
    }
  ],
  "nextPageToken": string
}
Felder
tasks[]

object (Task)

Die Aufgaben für die angeforderte trackingId. Eine erfolgreiche Antwort kann auch leer sein. Eine leere Antwort bedeutet, dass dem bereitgestellten trackingId keine Aufgaben zugeordnet sind.
nextPageToken

string

Übergeben Sie dieses Token in der SearchTasksRequest, um mit der Ergebnisliste fortzufahren. Wenn alle Ergebnisse zurückgegeben wurden, ist dieses Feld entweder ein leerer String oder wird nicht in der Antwort angezeigt.