با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
همه درخواست‌های ارسال شده به APIهای Google Photos به عنوان یک سهمیه محاسبه می‌شوند. ما این محدودیت ها را برای محافظت از سیستم و کاربران آن در نظر گرفته ایم.
دسترسی به API به اعتبارنامه مشتری OAuth از یک پروژه توسعه دهندگان Google نیاز دارد. این پروژه باید APIهای Photos را همانطور که در پیکربندی برنامه خود توضیح داده شده است فعال داشته باشد.
برای کسب اطلاعات بیشتر در مورد استفاده مناسب از این API، به خط مشی استفاده قابل قبول مراجعه کنید.
محدودیت های سهمیه عمومی
محدودیت سهمیه درخواست‌ها به Photos API 10000 درخواست در هر پروژه در روز است. این شامل تمام درخواست‌های API، مانند آپلود، فهرست کردن رسانه‌ها، و اعمال فیلترها می‌شود، اما دسترسی به بایت‌های رسانه از URL پایه را ندارد.
محدودیت سهمیه درخواست برای دسترسی به بایت های رسانه (با بارگیری عکس یا ویدیو از URL پایه ) 75000 درخواست در هر پروژه در روز است.
علاوه بر این محدودیت‌ها، سهمیه‌های دیگری نیز برای محافظت از قابلیت اطمینان و یکپارچگی سیستم‌های ما وجود دارد. اگر خطای 429 دریافت کردید، احتمالاً یکی از این سهمیه ها را زده اید. اگر یکی از این خطاها را دریافت کردید، تعداد درخواست هایی را که در یک بازه زمانی معین انجام می دهید کاهش دهید. برای اطلاعات بیشتر، به تلاش مجدد درخواست های ناموفق و عقب نشینی نمایی مراجعه کنید.
بررسی میزان استفاده از سهمیه
برای اینکه ببینید چه مقدار از سهمیه موجود خود را استفاده کرده‌اید، و برای مشاهده یا تغییر محدودیت‌های استفاده برای پروژه‌تان، از صفحه سهمیه‌ها در Google API Console دیدن کنید و Photos Picker API یا Photos Library API را انتخاب کنید.
فراتر از حد نصاب
اگر از سهمیه درخواست‌های Photos API فراتر رود، API کد خطای 429 و پیامی مبنی بر اینکه پروژه از سهمیه فراتر رفته است را برمی‌گرداند. برای اطلاعات بیشتر، به شرایط خدمات مراجعه کنید.
درخواست سهمیه اضافی
برنامه شریک Google Photos برای برنامه‌های مصرف‌کننده بزرگی طراحی شده است که به محدودیت‌های سهمیه‌ای افزایش یافته نیاز دارند. اگر فکر می کنید درخواست شما در این دسته قرار دارد، به برنامه شریک ابراز علاقه کنید .
ذخیره سازی عکس و کیفیت
همه موارد رسانه آپلود شده در Google Photos با استفاده از API با وضوح کامل با کیفیت اصلی ذخیره می شوند. آنها برای ذخیره سازی کاربر به حساب می آیند.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]
