Method: orders.list

Lists the orders in your Merchant Center account.

HTTP request

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/orders

Path parameters

Parameters
merchantId

string

The ID of the account that manages the order. This cannot be a multi-client account.

Query parameters

Parameters
maxResults

integer (uint32 format)

The maximum number of orders to return in the response, used for paging. The default value is 25 orders per page, and the maximum allowed value is 250 orders per page.

pageToken

string

The token returned by the previous request.

statuses[]

enum (Statuses)

Obtains orders that match any of the specified statuses. Note that active is a shortcut for pendingShipment and partiallyShipped, and completed is a shortcut for shipped, partiallyDelivered, delivered, partiallyReturned, returned, and canceled.

placedDateStart

string

Obtains orders placed after this date (inclusively), in ISO 8601 format.

placedDateEnd

string

Obtains orders placed before this date (exclusively), in ISO 8601 format.

orderBy

string

Order results by placement date in descending or ascending order.

Acceptable values are:

  • placedDateAsc
  • placedDateDesc

acknowledged

boolean

Obtains orders that match the acknowledgement status. When set to true, obtains orders that have been acknowledged. When false, obtains orders that have not been acknowledged.

We recommend using this filter set to false, in conjunction with the acknowledge call, such that only un-acknowledged orders are returned.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

JSON representation
{
  "nextPageToken": string,
  "kind": string,
  "resources": [
    {
      object (Order)
    }
  ]
}
Fields
nextPageToken

string

The token for the retrieval of the next page of orders.

kind

string

Identifies what kind of resource this is. Value: the fixed string "content#ordersListResponse".

resources[]

object (Order)

Authorization scopes

Requires one of the following OAuth scopes:

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

For more information, see the OAuth 2.0 Overview.

Statuses

Enums
ACTIVE Return orders with status active. The active status includes pendingShipment and partiallyShipped orders.
COMPLETED Return orders with status completed. The completed status includes shipped, partiallyDelivered, delivered, partiallyReturned, returned, and canceled orders.
CANCELED Return orders with status canceled.
IN_PROGRESS Return orders with status inProgress.
PENDING_SHIPMENT Return orders with status pendingShipment.
PARTIALLY_SHIPPED Return orders with status partiallyShipped.
SHIPPED Return orders with status shipped.
PARTIALLY_DELIVERED Return orders with status partiallyDelivered.
DELIVERED Return orders with status delivered.
PARTIALLY_RETURNED Return orders with status partiallyReturned.
RETURNED Return orders with status returned.