Method: mediaItems.search

Solicitação HTTP

POST https://photoslibrary.googleapis.com/v1/mediaItems:search

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

{
  "albumId": string,
  "pageSize": integer,
  "pageToken": string,
  "filters": {
    object (Filters)
  },
  "orderBy": string
}

Corpo da resposta

{
  "mediaItems": [
    {
      object (MediaItem)
    }
  ],
  "nextPageToken": string
}

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

• https://www.googleapis.com/auth/photoslibrary
• https://www.googleapis.com/auth/photoslibrary.readonly
• https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
• https://www.googleapis.com/auth/photoslibrary.readonly.originals

Filtros que podem ser aplicados a uma pesquisa de item de mídia. Se várias opções de filtro forem especificadas, elas serão tratadas como "E".

Esse filtro define as datas ou os períodos permitidos para a mídia retornada. É possível escolher um conjunto de datas específicas e um conjunto de períodos. Os itens de mídia enviados sem metadados que especificam a data em que o item de mídia foi capturado não são retornados em consultas que usam filtros de data. O tempo de upload do servidor do Google Fotos não é usado como substituto nesse caso.

Representa uma data inteira do calendário. Defina day como 0 quando apenas o mês e o ano forem importantes, por exemplo, todo o período de dezembro de 2018. Defina day e month como 0 se apenas o ano for importante, por exemplo, todo o ano de 2018. Defina year como 0 quando apenas o dia e o mês forem importantes, por exemplo, uma data comemorativa ou um aniversário.

Não compatível: definir todos os valores como 0, somente month como 0 ou day e year como 0 ao mesmo tempo.

Define um período. As duas datas precisam estar no mesmo formato. Para mais informações, consulte Date.

Esse filtro permite retornar itens de mídia com base no tipo de conteúdo.

É possível especificar uma lista de categorias a serem incluídas e/ou uma lista de categorias a serem excluídas. Em cada lista, as categorias são combinadas com um OU.

O filtro de conteúdo includedContentCategories: [c1, c2, c3] vai receber itens de mídia que contêm (c1 OU c2 OU c3).

O filtro de conteúdo excludedContentCategories: [c1, c2, c3] NÃO receberia itens de mídia que contenham (c1 OR c2 OR c3).

Você também pode incluir algumas categorias e excluir outras, como neste exemplo: includedContentCategories: [c1, c2], excludedContentCategories: [c3, c4]

O exemplo anterior obteria itens de mídia que contêm (c1 OR c2) AND NOT (c3 OR c4). Uma categoria que aparece em includedContentategories não pode aparecer em excludedContentCategories.

Esse é um conjunto de categorias de conteúdo predefinidas que você pode filtrar.

Esse filtro define o tipo de itens de mídia que serão retornados, por exemplo, vídeos ou fotos. Somente um tipo de mídia é compatível.

O conjunto de tipos de mídia que podem ser pesquisados.

Esse filtro define os recursos que os itens de mídia devem ter.

O conjunto de recursos que podem ser filtrados.