rocket Meet
Merchant API - جانشین رسمی Content API برای خرید.
update جدیدترین ویژگی‌های Merchant API، رفع اشکال‌ها و به‌روزرسانی‌ها
را دریافت کنید .
add_alert توجه: Content API برای خرید در 18 اوت 2026 غروب می‌کند.
حساب های خدماتی
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
حساب‌های سرویس، حساب‌های Google ویژه‌ای هستند که می‌توانند توسط برنامه‌ها برای دسترسی برنامه‌نویسی به Google API از طریق OAuth 2.0 استفاده شوند. یک حساب سرویس از یک جریان OAuth 2.0 استفاده می کند که به مجوز انسانی نیاز ندارد. در عوض، از یک فایل کلیدی استفاده می کند که فقط برنامه شما می تواند به آن دسترسی داشته باشد. این راهنما نحوه دسترسی به Content API برای خرید با حساب‌های سرویس را مورد بحث قرار می‌دهد.
توجه: برنامه‌هایی که از حساب‌های سرویس برای احراز هویت استفاده می‌کنند، فقط می‌توانند به حساب Merchant Center خود دسترسی داشته باشند. اگر در حال نوشتن یک برنامه شخص ثالث هستید که نیاز به دسترسی به حساب‌های Merchant Center مشتریان شما دارد، لطفاً به جای آن به راهنمای درخواست‌های مجاز مراجعه کنید.
پیش نیازها
مراحل استفاده از حساب سرویس برای دسترسی به Content API برای خرید
- اعتبارنامه حساب سرویس ایجاد کنید یا به اعتبارنامه های عمومی که قبلاً ایجاد کرده اید دسترسی پیدا کنید. شما باید یک شناسه مشتری OAuth 2.0 ایجاد کنید و یک فایل کلید خصوصی *.json دریافت کنید:
- به کنسول API Google بروید.
- یک پروژه را در منوی کشویی در بالای صفحه انتخاب کنید. اگر هنوز یکی را ندارید، با کلیک کردن روی پروژه جدید ، یکی ایجاد کنید.
- اگر قبلاً Content API را برای خرید این پروژه فعال نکرده‌اید، آن را در فهرست APIهای Google جستجو کرده و آن را فعال کنید.
- در نوار کناری سمت چپ، اعتبارنامه ها را انتخاب کنید. برای دیدن این مورد ممکن است لازم باشد روی فلش سمت چپ در بالا سمت چپ کلیک کنید.
- برای تنظیم یک حساب سرویس، CREATE CREDENTIALS و سپس Service account را انتخاب کنید.
- حساب سرویس جدید را نام ببرید. این همچنین به عنوان نام کاربری پیش‌فرض برای شناسه حساب سرویس عمل می‌کند. شناسه حساب سرویس، از جمله قسمت بعد از نویسه «@» را برای استفاده بعدی ضبط کنید. روی CREATE کلیک کنید، سپس مراحل اختیاری اعطای دسترسی به پروژه و کاربران را طی کنید و روی انجام شد کلیک کنید.
انتخاب نقش برای حساب سرویس هیچ تأثیری بر تماس‌هایی که می‌توان با Content API انجام داد، نخواهد داشت، زیرا دسترسی به روش‌های Content API در عوض با نقش مرتبط با شناسه حساب سرویس در Merchant Center تعیین می‌شود. اگر مطمئن نیستید چه چیزی را انتخاب کنید، فقط Project > Viewer را انتخاب کنید.
- به صفحه حساب‌های خدمات هدایت می‌شوید، جایی که می‌توانید به حساب سرویس جدیدتان دسترسی پیدا کنید.
- برای به دست آوردن یک کلید خصوصی JSON، روی حساب سرویس و سپس برگه KEYS کلیک کنید. روی ADD KEY > Create new key کلیک کنید و سپس JSON را به عنوان نوع کلید انتخاب کنید. برای دانلود کلید خصوصی در رایانه خود، روی CREATE کلیک کنید.
- حساب سرویس جدید را به عنوان کاربر به حساب Merchant Center خود اضافه کنید. اگر شما یک توسعه دهنده شخص ثالث هستید، باید از مشتری خود بخواهید این مرحله را برای شما انجام دهد.
- به حساب Merchant Center خود بروید.
- در تنظیمات حساب Merchant Center خود به Account Access بروید.
- روی + افزودن کاربر کلیک کنید و از شناسه حساب سرویس به عنوان آدرس ایمیل کاربر جدید استفاده کنید.
اگر قبلاً شناسه حساب سرویس را یادداشت نکرده‌اید، به صفحه مدیریت حساب‌های سرویس بروید و پروژه‌ای را که ایجاد کرده‌اید انتخاب کنید.
- تنظیمات برگزیده دسترسی کاربر و اعلان‌های ایمیل را برای حساب سرویس مشخص کنید. توجه داشته باشید که استفاده از سرویس
Accounts نیاز به دسترسی Admin دارد. - برای ذخیره تنظیمات برگزیده و بازگشت به لیست کاربران، روی افزودن کاربر کلیک کنید. شناسه حساب سرویس باید با نقش کاربر انتخابی فهرست شود.
- این فرآیند را برای همه حساب‌های سرویس دیگری که می‌خواهید اضافه کنید، تکرار کنید.
- اکنون می‌توانید با استفاده از جریان اعتبارنامه پیش‌فرض Google Application یا با استفاده مستقیم از جریان حساب سرویس ، به حساب Merchant Center خود با استفاده از حساب سرویس دسترسی پیدا کنید. Content API برای نمونه‌های خرید نشان می‌دهد که چگونه می‌توان از هر دو جریان برای اعتبار حساب سرویس در هر زبان برنامه‌نویسی پشتیبانی‌شده استفاده کرد. لطفاً نمونه‌های کد را بررسی کنید تا حساب سرویس جدید خود را امتحان کنید و بدانید برای استفاده از حساب‌های سرویس در کد خود به چه تغییراتی نیاز دارید.
سوالات متداول
- آیا می توانم با حساب سرویس خود وارد رابط کاربری Merchant Center شوم؟
- خیر، حساب‌های سرویس، حساب‌های Google معمولی نیستند و نمی‌توانند به رابط کاربری Merchant Center دسترسی داشته باشند.
- هر چند وقت یک‌بار باید نشانه‌های دسترسی به حساب سرویس را بازخوانی کنم؟
- توکن‌های دسترسی یک ساعت پس از صدور توسط سرور مجوز Google OAuth 2.0 منقضی می‌شوند. هنگامی که یک نشانه دسترسی منقضی می شود، برنامه باید از کتابخانه مشتری برای واکشی نشانه دسترسی دیگری استفاده کند.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eService accounts enable applications to programmatically access Google APIs, including the Content API for Shopping, using OAuth 2.0 without human intervention.\u003c/p\u003e\n"],["\u003cp\u003eTo utilize service accounts, you need to generate service account credentials, add the service account as a user in your Merchant Center account, and then access your Merchant Center account using either the Google Application Default Credentials flow or the service account flow.\u003c/p\u003e\n"],["\u003cp\u003eApplications authenticated with service accounts can only access your own Merchant Center account; for third-party applications needing access to client accounts, refer to the Authorizing Requests guide.\u003c/p\u003e\n"],["\u003cp\u003eService accounts cannot be used to sign in to the Merchant Center UI and access tokens expire after one hour, requiring the application to fetch a new one using the client library.\u003c/p\u003e\n"]]],["Service accounts allow applications to access the Content API for Shopping programmatically. Key actions include: generating service account credentials by creating an OAuth 2.0 Client ID and a JSON private key file via the Google API Console, and adding the service account as a user within the Merchant Center account, specifying access and notification preferences. To access the Merchant center, you can use Google Application Default Credentials or a service account flow, with example code available. Access tokens expire hourly, requiring renewal.\n"],null,["# Service accounts are special Google accounts that can be used by\napplications to access Google APIs programmatically via OAuth 2.0. A service\naccount uses an OAuth 2.0 flow that does not require human authorization.\nInstead, it uses a key file that only your application can access. This guide\ndiscusses how to access the Content API for Shopping with service accounts.\n\n**Note:** Applications using service accounts\nfor authentication can only access your own Merchant Center account. If you are\nwriting a third-party application that needs access to your clients' Merchant\nCenter accounts, please see the [Authorizing Requests](/shopping-content/guides/how-tos/authorizing)\nguide instead.\n\nPrerequisites\n-------------\n\n- A [Merchant Center](//merchants.google.com/) account.\n\nSteps to using a service account to access the Content API for Shopping\n-----------------------------------------------------------------------\n\n1. Generate service account credentials or access the public credentials you've already generated. You will need to create an OAuth 2.0 Client ID and obtain a \\*.json private key file:\n 1. Go to the [Google API Console](https://console.cloud.google.com/apis/library).\n 2. Select a project in the drop-down menu at the top of the page. If you do not have one yet, create one by clicking **NEW PROJECT**.\n 3. If you have not already enabled the Content API for Shopping for this project, then search for it in the list of Google APIs and enable it.\n 4. In the sidebar on the left, select **Credentials**. You may need to click the left-pointing arrow at the top left to see this.\n 5. To set up a service account, select **CREATE CREDENTIALS** , and then **Service account** . \n 6. Name the new service account. This also serves as the default username for the service account ID. Record the service account ID, including the part after the '@' character, for later use. Click **CREATE** , then go through the optional steps of granting access to project and users, and click **DONE** .\n\n The choice of role for the service account will not\n have any effect on what calls can be made to the Content API, as access to\n Content API methods is determined instead by the role associated with the\n service account ID in Merchant Center. If you are unsure what to pick, just\n pick **Project \\\u003e Viewer**.\n 7. You will be directed to the Service Accounts page where your new service account can be accessed.\n 8. To obtain a JSON private key, click on the service account, then the **KEYS** tab. Click **ADD KEY \\\u003e Create new key** and then select JSON as the key type. Click **CREATE** to download the private key to your computer.\n2. Add the new service account as a user to your Merchant Center account. If you are a third-party developer, you will need to have your client do this step for you.\n 1. Go to your [Merchant\n Center account](//merchants.google.com/).\n 2. Go to **Account Access** in the settings of your Merchant Center account.\n 3. Click **+ Add user** and use the service account ID as the email address for the new user.\n\n If you did not take note of the\n service account ID earlier, go to the [Service\n Accounts](//console.developers.google.com/iam-admin/serviceaccounts/) administration page and select the project you created.\n 4. Specify the **User access** and **Email notifications** preferences for the service account. Note that the use of the `Accounts` service requires **Admin** access.\n 5. Click **Add user** to save preferences and be returned to the list of users. The service account ID should be listed with the chosen user role.\n 6. Repeat the process for all other service accounts you want to add.\n3. Now you can access your Merchant Center account using the service account either by using the [Google Application\n Default Credentials](/identity/protocols/application-default-credentials) flow or by using the [service account flow](/identity/protocols/OAuth2ServiceAccount) directly. The Content API for Shopping [Samples](/shopping-content/guides/libraries) show how to use both flows for service account credentials in each supported programming language. Please check out the code samples to try out your new service account and to learn what changes you will need to use service accounts in your own code.\n\nFrequently asked questions\n--------------------------\n\nCan I sign in to the Merchant Center UI with my service account?\n: No, service accounts are not regular Google accounts and cannot access the\n Merchant Center UI.\n\nHow often do I need to refresh service account access tokens?\n: Access tokens expire one hour after they are issued by the Google OAuth 2.0\n Authorization Server. When an access token expires, the application should use\n the client library to fetch another access token."]]
