Nome |
Tipo |
Necessário |
Descrição |
Caminho |
Cadeia |
Sim |
O caminho para a pasta. |
file_limit |
número inteiro |
Não |
O padrão é 10.000 (o máximo é 25.000). Ao listar uma pasta, o serviço não relatará listagens contendo mais do que a quantidade especificada de arquivos e, em vez disso, responderá com uma resposta de status 406 (Não aceitável). |
hash |
Cadeia |
Não |
Cada chamada para /metadata em uma pasta retornará um campo hash, gerado pela realização de hash de todos os metadados contidos nessa resposta. Em
chamadas posteriores para /metadata, é necessário fornecer esse valor por meio desse parâmetro para que, se nada tiver mudado, a resposta seja um código de
status 304 (Não
modificado), em vez da listagem de pasta completa, potencialmente muito grande. Esse parâmetro será ignorado se o caminho especificado estiver associado a um arquivo ou se list=false. |
list |
boolean |
Não |
As sequências true e false são valores válidos. true é o padrão. Se true, os metadados da pasta incluirão um campo de conteúdo com uma lista de entradas de metadados para o conteúdo da pasta. Se false, o campo de conteúdo será omitido. |
include_deleted |
Booleano |
Não |
Somente aplicável quando list estiver configurado. Se esse parâmetro for configurado como true, o conteúdo incluirá os metadados de filhos excluídos. Observe que o destino da chamada de metadados é sempre retornado mesmo quando foi excluído (com is_deleted configurado como true), independentemente dessa sinalização. |
rev |
string |
Não |
Se você incluir um número de revisão específico, somente os metadados para essa revisão serão retornados. |
código de idioma |
Cadeia |
Não |
Os metadados retornados terão seu campo de tamanho convertido com base no código de idioma especificado. |
include_media_info |
boolean |
Não |
Se true, cada arquivo incluirá um dicionário photo_info para fotos e um dicionário video_info para vídeos com informações adicionais de mídia. Se os dados ainda não estiverem disponíveis, a sequência pendente será retornada no lugar de um dicionário. |
include_membership |
boolean |
não |
Se for true, os metadados para uma pasta compartilhada incluirão uma lista de membros e uma lista de grupos. |