Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tất cả yêu cầu gửi đến API Google Photos đều được tính vào hạn mức. Chúng tôi đặt ra các giới hạn này để bảo vệ hệ thống và người dùng.
Để truy cập vào API, bạn cần có thông tin xác thực ứng dụng OAuth từ một dự án dành cho nhà phát triển của Google. Dự án này phải bật API Photos như mô tả trong phần Định cấu hình ứng dụng.
Để tìm hiểu thêm về cách sử dụng API này sao cho phù hợp, hãy xem Chính sách sử dụng.
Giới hạn chung của hạn mức
Hạn mức hạn mức cho các yêu cầu gửi đến API Photos là 10.000 yêu cầu/dự án/ngày. Điều này bao gồm tất cả yêu cầu API, chẳng hạn như tải lên, liệt kê nội dung nghe nhìn và áp dụng các bộ lọc, nhưng không truy cập vào các byte nội dung nghe nhìn từ URL cơ sở.
Hạn mức hạn mức cho các yêu cầu truy cập vào byte nội dung nghe nhìn (bằng cách tải ảnh hoặc video từ URL cơ sở) là 75.000 yêu cầu mỗi dự án mỗi ngày.
Ngoài những giới hạn này, chúng tôi còn áp dụng các hạn mức khác để bảo vệ độ tin cậy và tính toàn vẹn của hệ thống. Nếu bạn gặp lỗi 429, có thể bạn đã đạt đến một trong các hạn mức này. Nếu bạn gặp phải một trong những lỗi này, hãy giảm số lượng yêu cầu bạn đang thực hiện trong một khoảng thời gian nhất định. Để biết thêm thông tin, hãy tham khảo thử lại các yêu cầu không thành công và thời gian đợi luỹ thừa.
Kiểm tra mức sử dụng hạn mức
Để xem bạn đã sử dụng bao nhiêu trong hạn mức hiện có và để xem hoặc thay đổi giới hạn sử dụng cho dự án, hãy truy cập vào trang Định mức trong Google API Console rồi chọn Photos Picker API hoặc Photos Library API.
Vượt quá hạn mức
Nếu vượt quá hạn mức yêu cầu đối với API Photos, API sẽ trả về mã lỗi 429 và thông báo rằng dự án đã vượt quá hạn mức. Để biết thêm thông tin, hãy xem Điều khoản dịch vụ.
Yêu cầu hạn mức bổ sung
Chương trình đối tác của Google Photos hướng đến các ứng dụng lớn dành cho người tiêu dùng cần tăng hạn mức hạn mức. Nếu bạn cho rằng ứng dụng của mình thuộc danh mục này, hãy bày tỏ sự quan tâm đến chương trình đối tác.
Chất lượng và bộ nhớ ảnh
Tất cả mục nội dung nghe nhìn được tải lên Google Photos bằng API đều được lưu trữ ở độ phân giải đầy đủ với chất lượng gốc. Các tệp này được tính vào bộ nhớ của người dùng.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 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."]]
