rocket ,
Merchant API — официальный преемник Content API for Shopping.
add_alert Примечание: API контента для покупок прекратит работу 18 августа 2026 г.
Сервисные аккаунты
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Учетные записи служб — это специальные учетные записи Google, которые могут использоваться приложениями для программного доступа к API Google через OAuth 2.0. Учетная запись службы использует поток OAuth 2.0, который не требует авторизации человека. Вместо этого он использует файл ключа, к которому имеет доступ только ваше приложение. В этом руководстве описывается, как получить доступ к Content API для покупок с помощью учетных записей служб.
Примечание. Приложения, использующие сервисные учетные записи для аутентификации, могут получить доступ только к вашей собственной учетной записи Merchant Center. Если вы пишете стороннее приложение, которому требуется доступ к учетным записям Merchant Center ваших клиентов, вместо этого обратитесь к руководству по авторизации запросов .
Предварительные условия
Действия по использованию сервисного аккаунта для доступа к Content API для покупок
- Создайте учетные данные сервисной учетной записи или получите доступ к уже созданным общедоступным учетным данным. Вам нужно будет создать идентификатор клиента OAuth 2.0 и получить файл закрытого ключа *.json:
- Перейдите в консоль Google API .
- Выберите проект в раскрывающемся меню вверху страницы. Если у вас его еще нет, создайте его, нажав НОВЫЙ ПРОЕКТ .
- Если вы еще не включили Content API for Shopping для этого проекта, найдите его в списке API Google и включите.
- На боковой панели слева выберите «Учетные данные» . Чтобы увидеть это, возможно, вам придется щелкнуть стрелку, указывающую влево, в левом верхнем углу.
- Чтобы настроить учетную запись службы, выберите CREATE CREDENTIALS , а затем учетную запись службы .
- Назовите новую учетную запись службы. Это также имя пользователя по умолчанию для идентификатора учетной записи службы. Запишите идентификатор учетной записи службы, включая часть после символа «@», для дальнейшего использования. Нажмите СОЗДАТЬ , затем выполните дополнительные шаги по предоставлению доступа к проекту и пользователям и нажмите ГОТОВО .
Выбор роли сервисного аккаунта не повлияет на то, какие вызовы могут быть сделаны в Content API, поскольку вместо этого доступ к методам Content API определяется ролью, связанной с идентификатором сервисного аккаунта в Merchant Center. Если вы не уверены, что выбрать, просто выберите Project > Viewer .
- Вы будете перенаправлены на страницу учетных записей служб, где можно получить доступ к вашей новой учетной записи службы.
- Чтобы получить закрытый ключ JSON, щелкните учетную запись службы, а затем вкладку КЛЮЧИ . Нажмите «ДОБАВИТЬ КЛЮЧ» > «Создать новый ключ» , а затем выберите JSON в качестве типа ключа. Нажмите СОЗДАТЬ , чтобы загрузить закрытый ключ на свой компьютер.
- Добавьте новый сервисный аккаунт в качестве пользователя в свой аккаунт Merchant Center. Если вы сторонний разработчик, вам необходимо, чтобы ваш клиент сделал этот шаг за вас.
- Перейдите в свой аккаунт Merchant Center .
- Перейдите в раздел «Доступ к учетной записи» в настройках вашего аккаунта Merchant Center.
- Нажмите + Добавить пользователя и используйте идентификатор сервисной учетной записи в качестве адреса электронной почты для нового пользователя.
Если вы ранее не записали идентификатор учетной записи службы, перейдите на страницу администрирования учетных записей служб и выберите созданный вами проект.
- Укажите настройки доступа пользователя и уведомлений по электронной почте для учетной записи службы. Обратите внимание, что для использования службы
Accounts требуется доступ администратора . - Нажмите «Добавить пользователя» , чтобы сохранить настройки и вернуться к списку пользователей. Идентификатор учетной записи службы должен быть указан вместе с выбранной ролью пользователя.
- Повторите процедуру для всех остальных учетных записей служб, которые вы хотите добавить.
- Теперь вы можете получить доступ к своей учетной записи Merchant Center с помощью учетной записи службы либо с помощью потока учетных данных по умолчанию для приложения Google, либо напрямую с помощью потока учетной записи службы . В примерах Content API for Shopping показано, как использовать оба потока для учетных данных сервисной учетной записи на каждом поддерживаемом языке программирования. Ознакомьтесь с примерами кода, чтобы опробовать свою новую учетную запись службы и узнать, какие изменения вам потребуются для использования учетных записей службы в вашем собственном коде.
Часто задаваемые вопросы
- Могу ли я войти в пользовательский интерфейс Merchant Center с помощью своего сервисного аккаунта?
- Нет, сервисные аккаунты не являются обычными аккаунтами Google и не имеют доступа к пользовательскому интерфейсу Merchant Center.
- Как часто мне нужно обновлять токены доступа к учетной записи службы?
- Срок действия токенов доступа истекает через час после их выдачи сервером авторизации Google OAuth 2.0. По истечении срока действия токена доступа приложение должно использовать клиентскую библиотеку для получения другого токена доступа.
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-29 UTC.
[null,null,["Последнее обновление: 2025-08-29 UTC."],[[["\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."]]
