v1Recursos/Media/getListar as fotos do Google armazenadas
Listar as fotos do Google armazenadas
Retorna as fotos do Google armazenadas em todos os locais a que a chave tem acesso. Filtre por locationId, clientId ou kind e pagine com nextCursor. Leitura apenas do que está armazenado: nunca chama o Google nem inicia uma sincronização. Aqui o location de nível superior é null somente quando locationId não é enviado; com locationId ele traz a cobertura desse local mesmo com items vazio. cada item traz seu próprio local e sua atualização. A biblioteca de mídia da própria Synup por categoria é outra leitura: GET /api/v1/media?locationId.
get
media:read/api/v1/media/googleParâmetros de consulta
locationIdstringopcional
Somente fotos deste local. Aceita o id público loc_, o id nativo ou um id legado. Ele deve pertencer ao clientId se você enviar os dois.
clientIdstringopcional
Somente fotos de locais deste cliente. A chave precisa ter acesso a esse cliente.
kindstring (owner | ugc)opcional
owner para fotos enviadas pela empresa, ugc para fotos de clientes. Omita para receber ambas.
limitintegeropcional
Tamanho da página, um número inteiro de 1 a 100. Padrão 50. Qualquer outro valor é rejeitado, não ajustado.
cursorstringopcional
O nextCursor da página anterior. Só funciona com os mesmos filtros; um cursor de outra solicitação é rejeitado.
Resposta
dataobjectopcional
itemsarray of objectopcional
Um item por associação de foto e local, do mais recente ao mais antigo. Uma foto compartilhada por vários locais aparece uma vez para cada local a que você tem acesso.
idstringopcional
O id do registro da foto armazenada. É compartilhado por todos os locais vinculados à foto, então identifique cada linha por associationKey.
associationKeystringopcional
Único por foto e local: o id e o id do local unidos por dois-pontos.
externalIdstringopcional
O nome completo do recurso no Google. É a identidade da foto: a mesma URL com outro externalId é outra foto.
urlstringopcional
A URL hospedada no Google. Uma referência à foto no Google, não uma cópia guardada pela Synup. Uma foto enviada pela Synup pode manter a URL de origem até a próxima coleta agendada.
categorystringopcional
A categoria própria do Google para a foto, ou null quando o Google não informou. Não é o mesmo que kind.
formatstringopcional
O formato da mídia como armazenado, por exemplo PHOTO, ou null.
kindstring (owner | ugc)opcional
owner para uma foto enviada pela empresa, ugc para uma foto de cliente.
lastSeenAtstringopcional
Quando uma resposta do Google incluiu esta foto neste local pela última vez, ou null se desconhecido. Uma foto enviada depois do início de uma verificação também conta como vista.
presencestring (seen_in_last_complete_scan | not_seen_in_last_complete_scan | unknown)opcional
Se a última verificação completa viu esta foto: seen_in_last_complete_scan, not_seen_in_last_complete_scan ou unknown quando ainda não há verificação completa. Registra o que foi observado e nunca significa que o Google a excluiu.
moderationobjectopcional
Estado de revisão da foto.
statusstring (ok | needs_review | spam | skipped)opcional
ok, needs_review, spam ou skipped; null quando não classificada. Fotos marcadas como spam ou needs_review continuam sendo retornadas, nunca filtradas.
locationobjectopcional
O local ao qual esta foto está vinculada.
idstringopcional
O id público do local.
namestringopcional
O nome do local, ou null.
clientIdstringopcional
O cliente dono do local, ou null para um local sem cliente.
freshnessobjectopcional
Quão recentes e completos estão os dados armazenados para este tipo de foto neste local. Campos null significam desconhecido ou nunca tentado, nunca completo.
coveragestring (complete | partial | unavailable)opcional
complete, partial ou unavailable; null quando nenhuma atualização foi tentada.
outcomestring (complete | incomplete | unavailable | failed | not_connected)opcional
Resultado da última tentativa de atualização: complete, incomplete, unavailable, failed ou not_connected.
lastAttemptAtstringopcional
Quando a última atualização foi tentada.
lastSuccessAtstringopcional
Quando rodou a última atualização que terminou completa.
completedScanAtstringopcional
Quando a última verificação completa começou. presence compara lastSeenAt com esse instante.
locationobjectopcional
Presente ao ler um único local, mesmo com items vazio: o local com a atualização de owner e ugc. null na rota de coleção sem locationId.
idstringopcional
O id público do local.
namestringopcional
O nome do local, ou null.
clientIdstringopcional
O cliente dono do local, ou null para um local sem cliente.
ownerobjectopcional
Quão recentes e completos estão os dados armazenados para este tipo de foto neste local. Campos null significam desconhecido ou nunca tentado, nunca completo.
coveragestring (complete | partial | unavailable)opcional
complete, partial ou unavailable; null quando nenhuma atualização foi tentada.
outcomestring (complete | incomplete | unavailable | failed | not_connected)opcional
Resultado da última tentativa de atualização: complete, incomplete, unavailable, failed ou not_connected.
lastAttemptAtstringopcional
Quando a última atualização foi tentada.
lastSuccessAtstringopcional
Quando rodou a última atualização que terminou completa.
completedScanAtstringopcional
Quando a última verificação completa começou. presence compara lastSeenAt com esse instante.
ugcobjectopcional
Quão recentes e completos estão os dados armazenados para este tipo de foto neste local. Campos null significam desconhecido ou nunca tentado, nunca completo.
coveragestring (complete | partial | unavailable)opcional
complete, partial ou unavailable; null quando nenhuma atualização foi tentada.
outcomestring (complete | incomplete | unavailable | failed | not_connected)opcional
Resultado da última tentativa de atualização: complete, incomplete, unavailable, failed ou not_connected.
lastAttemptAtstringopcional
Quando a última atualização foi tentada.
lastSuccessAtstringopcional
Quando rodou a última atualização que terminou completa.
completedScanAtstringopcional
Quando a última verificação completa começou. presence compara lastSeenAt com esse instante.
limitintegeropcional
O tamanho de página aplicado.
nextCursorstringopcional
Passe como cursor para obter a próxima página. null quando não há mais.
Erros
400limit, kind, um filtro ou o cursor é inválido, um parâmetro foi repetido ou o local não pertence ao clientId enviado. O campo code indica a causa.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não está autorizada para esse cliente ou local. Um local sem cliente só é visível para chaves de toda a agência.
404O local não foi encontrado nesta agência.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
get/api/v1/media/google
Sua chave de API
locationId
clientId
kind
limit
cursor
{
"data": {
"items": [
{
"id": "4c7a1e90-2b6d-4d8f-9e35-71f0a8c2d413",
"associationKey": "4c7a1e90-2b6d-4d8f-9e35-71f0a8c2d413:loc_789",
"externalId": "accounts/102938475610293847561/locations/7788990011223344556/media/AF1QipOwnerSign03",
"url": "https://lh3.googleusercontent.com/p/AF1QipOwnerSign03",
"category": "EXTERIOR",
"format": "PHOTO",
"kind": "owner",
"lastSeenAt": "2026-10-12T04:01:58.000Z",
"presence": "seen_in_last_complete_scan",
"moderation": {
"status": null
},
"location": {
"id": "loc_789",
"name": "Acme Dental — Uptown",
"clientId": "cli_123"
},
"freshness": {
"coverage": "complete",
"outcome": "complete",
"lastAttemptAt": "2026-10-12T04:02:11.000Z",
"lastSuccessAt": "2026-10-12T04:02:11.000Z",
"completedScanAt": "2026-10-12T04:01:58.000Z"
}
}
],
"location": null,
"limit": 50,
"nextCursor": null
}
}