Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Todas as solicitações enviadas para as APIs do Google Fotos são contabilizadas em uma cota. Esses limites foram implementados para proteger o sistema e os usuários.
O acesso à API requer credenciais de cliente OAuth de um projeto do Google Developers. As APIs do Google Fotos precisam estar ativadas neste projeto, conforme descrito em
Configurar seu app.
O limite de cota para solicitações às APIs do Google Fotos é de 10.000 por
projeto por dia. Isso inclui todas as solicitações de API, como fazer upload, listar
mídia e aplicar filtros, mas não acessar bytes de mídia de um URL de base.
Além desses limites, há outras cotas para proteger a
confiabilidade e a integridade dos nossos sistemas. Se você receber o erro 429, provavelmente atingiu uma dessas cotas. Se você receber um desses erros, reduza o
número de solicitações feitas em um determinado período. Para mais
informações, consulte Repetir solicitações
com falha e
Espera
exponencial.
Como verificar o uso de cotas
Para saber qual parte da cota disponível você usou e para conferir ou mudar
os limites de uso do seu projeto, acesse a
página de cotas
no Console de APIs do Google e selecione a API Photos Picker ou a API
Photos Library.
Limites de cota excedentes
Se a cota de solicitações às APIs do Google Fotos for excedida, a API vai retornar um código de erro 429 e uma mensagem informando que o projeto excedeu a cota. Para
mais informações, consulte os Termos de
Serviço.
Como solicitar cotas extras
O programa de parceiros do Google Fotos é voltado para grandes aplicativos de consumo que exigem limites de cota maiores. Se você acredita que sua
candidatura se encaixa nessa categoria, expresse seu interesse no
programa de parceiros.
Armazenamento e qualidade das fotos
Todos os itens de mídia enviados por upload para o Google Fotos usando a API são armazenados em
resolução total com qualidade
original. Elas são contabilizadas no
armazenamento do usuário.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-29 UTC."],[[["\u003cp\u003eAll requests to Google Photos APIs are subject to daily quotas to protect the system, with 10,000 requests for general API functions and 75,000 for accessing media bytes.\u003c/p\u003e\n"],["\u003cp\u003eAPI access requires OAuth credentials from a Google Developers project with enabled Photos APIs, and usage should align with the Acceptable Use Policy.\u003c/p\u003e\n"],["\u003cp\u003eExceeding quota limits results in a 429 error, prompting the need to reduce request frequency and potentially implement retry mechanisms like exponential backoff.\u003c/p\u003e\n"],["\u003cp\u003eQuota usage can be monitored and managed through the Google API Console Quotas page, offering insights into consumption and the option to request quota increases for eligible applications.\u003c/p\u003e\n"],["\u003cp\u003eMedia uploaded via the API is stored in original quality, impacting user storage, and applications should inform users about potential storage implications for large uploads exceeding 25MB.\u003c/p\u003e\n"]]],["Google Photos APIs have usage quotas to protect the system. Access requires OAuth credentials and enabling the APIs in a Google Developers project. The general quota is 10,000 requests per project per day, excluding media byte access, which has a 75,000 daily request limit. Exceeding quotas results in a 429 error, requiring reduced request frequency. Quota usage can be monitored in the Google API Console. Uploaded media items are stored in full resolution and count toward user storage.\n"],null,["# API limits and quotas\n\nAll requests sent to the Google Photos APIs are counted toward a quota. We put these\nlimits in place to protect the system and its users.\n\nAccess to the API requires OAuth client credentials from a Google developers\nproject. This project must have the Photos APIs enabled as described in\n[Configure your app](/photos/overview/configure-your-app).\n\nTo learn more about appropriate use of this API, see the\n[Acceptable use policy](/photos/support/api-policy).\n\nGeneral quota limits\n--------------------\n\nThe quota limit for requests to the Photos APIs is 10,000 requests per\nproject per day. This includes all API requests, such as uploading, listing\nmedia, and applying filters, but not accessing media bytes from a base URL.\n\nThe quota limit for requests to access media bytes (by\n[loading a photo or video from a base\nURL](/photos/library/guides/access-media-items#base-urls))\nis 75,000 requests per project per day.\n\nIn addition to these limits there are other quotas that exist to protect the\nreliability and integrity of our systems. If you receive a 429 error, you've\nlikely hit one of these quotas. If you receive one of these errors, reduce the\nnumber of requests you are making over a given time period. For more\ninformation, refer to [retrying failed\nrequests](/photos/overview/best-practices#retrying-failed-requests) and\n[exponential\nbackoff](/photos/overview/best-practices#exponential-backoff).\n\n### Checking quota usage\n\nTo see how much of your available quota you have used, and to view or change\nusage limits for your project, visit the\n[Quotas page](https://console.cloud.google.com/iam-admin/quotas?service=photoslibrary.googleapis.com)\nin the Google API Console and select either **Photos Picker API** or **Photos\nLibrary API**.\n\n### Exceeding quota limits\n\nIf the quota of requests to the Photos APIs is exceeded, the API returns\nan error code 429 and a message that the project has exceeded the quota. For\nmore information, see the [Terms of\nService](https://developers.google.com/terms/).\n\n### Requesting additional quota\n\nThe Google Photos partner program is geared towards large consumer\napplications that require increased quota limits. If you believe your\napplication belongs in this category, [express interest in the\npartner program](/photos/partner-program/overview).\n\nPhoto storage and quality\n-------------------------\n\nAll media items uploaded to Google Photos using the API are stored in\nfull resolution at [original\nquality](https://support.google.com/photos/answer/6220791). They count toward\nthe user's storage.\n| **Note:** If your uploads exceed 25MB per user, your application should remind the user that these uploads will count towards storage in their Google Account."]]
