Method: sellers.orders.list

Muestra una lista de pedidos.

  • Por ejemplo: GET /v1/sellers/321/orders
  • Devuelve una lista de pedidos y un token para recuperar la página siguiente si se realiza con éxito.
  • Muestra el código de error PERMISSION_DENIED si el usuario no tiene acceso al vendedor o no existe un ID de vendedor.
  • Muestra el código de error INVALID_ARGUMENT si los vendedores proporcionan un tamaño de página o un token de página no válidos.

Solicitud HTTP

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/orders

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. El elemento superior, propietario de esta colección de pedidos. Formato: vendedores/{seller}

Parámetros de consulta

Parámetros
pageSize

integer

La cantidad máxima de elementos que se mostrarán. El servicio puede mostrar menos que este valor. La cantidad máxima permitida de pedidos es 1,000. Si no se especifica, se devolverán 1,000 pedidos como máximo.
pageToken

string

El valor nextPageToken que se muestra de una solicitud de lista previa, si existe.
filter

string

El filtro de lista. Actualmente es compatible con el filtrado de estado y de ID externo, con la sintaxis “externalId = [EXTERNAL_ID]”. y "estado = [STATE]". Los operadores lógicos AND y OR se pueden usar para encadenar filtros.
orderBy

string

Es el orden por cadena que se usa para especificar la clasificación de los resultados. Actualmente, se admiten pedidos realizados a través de updateTime, por lo que debes proporcionar "updateTime". para obtener resultados ordenados por updateTime en orden ascendente o "updateTime desc" para el orden descendente.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si el proceso es satisfactorio, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "orders": [
    {
      object (Order)
    }
  ],
  "nextPageToken": string
}
Campos
orders[]

object (Order)

Es la lista de pedidos.
nextPageToken

string

Un token para recuperar los resultados de la página siguiente. Pasa este valor en el campo pageToken en la llamada posterior al método orders.list para recuperar la siguiente página de resultados.

Alcances de la autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/doubleclickbidmanager

Para obtener más información, consulta la descripción general de OAuth 2.0.