REST Resource: sessions

Recurso: PickingSession

Representação de uma sessão do usuário em que ele pode escolher fotos e vídeos usando o Google Fotos.

Representação JSON 
{
  "id": string,
  "pickerUri": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "expireTime": string,
  "pickingConfig": {
    object (PickingConfig)
  },
  "mediaItemsSet": boolean
}
Campos
id

string

Apenas saída. Identificador gerado pelo Google para esta sessão.
pickerUri

string

Apenas saída. O URI usado para redirecionar o usuário ao Google Fotos (na Web) para que ele possa escolher fotos e vídeos para a sessão atual.

Para acessar essa página, o usuário precisa fazer login na Conta do Google que é proprietária da sessão no navegador da Web.

O pickerUri não pode ser aberto em um iframe por motivos de segurança.
pollingConfig

object (PollingConfig)

Apenas saída. A configuração recomendada que os aplicativos precisam usar ao consultar sessions.get.

Esse campo só é preenchido se os itens de mídia ainda não tiverem sido escolhidos para a sessão (ou seja, mediaItemsSet é falso).
expireTime

string (Timestamp format)

Apenas saída. Hora em que o acesso a esta sessão (e aos itens de mídia selecionados) vai expirar.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
pickingConfig

object (PickingConfig)

Opcional. Configuração de seleção de fotos para a experiência de seleção do usuário durante essa sessão.

Isso é especificado pelo aplicativo cliente ao chamar sessions.create e não pode ser modificado depois (sem criar uma nova sessão).
mediaItemsSet

boolean

Apenas saída. Se definido como true, os itens de mídia foram escolhidos para esta sessão, e o app pode solicitar a lista de itens de mídia escolhidos por mediaItems.list.

PollingConfig

Configuração para consultar a API.

Representação JSON 
{
  "pollInterval": string,
  "timeoutIn": string
}
Campos
pollInterval

string (Duration format)

Apenas saída. Tempo recomendado entre as solicitações de pesquisa.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
timeoutIn

string (Duration format)

Apenas saída. O período de tempo após o qual o cliente precisa parar de fazer a pesquisa.

Um valor de 0 indica que o cliente precisa parar de fazer a pesquisa, se ainda não tiver feito isso.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

PickingConfig

Configuração especificada pelo cliente para a experiência de seleção do usuário durante essa sessão.

Representação JSON 
{
  "maxItemCount": string
}
Campos
maxItemCount

string (int64 format)

Opcional. O número máximo de itens que o usuário pode escolher durante a sessão. O padrão é 2000 se não for especificado.

Se não for especificado ou definido como 0, no máximo 2.000 itens poderão ser selecionados. Valores acima de 2.000 serão convertidos para 2.000. Valores negativos resultarão em um erro INVALID_ARGUMENT.

Métodos

create

 Gera uma nova sessão em que o usuário pode escolher fotos e vídeos para acesso de terceiros.

delete

 Exclui a sessão especificada.

get

 Recupera informações sobre a sessão especificada.