重要: Content API for Shopping は 2026 年 8 月 18 日 に提供を終了しました。

2026 年 9 月 1 日より、Content API for Shopping のリクエストでエラーが段階的に発生するようになります。詳しくは、 Content API の提供終了に関するガイドをご覧ください。

Merchant API への移行に時間がかかる場合は、 Content API for Shopping へのアクセス期間の延長を申請してください。

Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

デベロッパーとして登録

デベロッパーとしての登録は、Google Cloud プロジェクトを Merchant Center アカウントにリンクし、デベロッパーの連絡先情報を Google に登録する、1 回限りの必須の設定プロセスです。これにより、Google は、提供された関連する技術担当者に重要なサービスに関するお知らせと必須の更新を送信できます。

このドキュメントは、Merchant API のスタートガイドに関する複数のパートからなるシリーズの一部です。すでに Merchant API に登録している場合は、次のセクション（最初の商品を登録する）に進んでください。

前提条件

Merchant API の使用を登録する前に、次の要件を満たしていることを確認してください。

Merchant Center アカウント: 既存の Merchant Center アカウントが必要です。登録は本番環境アカウントでのみサポートされています。テストアカウントはデベロッパー登録の対象外です。
確認済みのホームページ: Merchant Center アカウントに確認済みのウェブサイトが登録されている必要があります。これにより、ビジネスに関連付けられているドメインの所有権が証明されます。
Merchant Center アカウントの管理者権限: 登録呼び出しの承認に使用するメールアドレスまたはサービスアカウントには、登録先の Merchant Center アカウントの ADMIN アクセスタイプが必要です。詳細については、Merchant API へのリクエストの承認をご覧ください。
Google Cloud プロジェクト ID: 認証用の認証情報を提供するには、アプリケーションを専用の Google Cloud プロジェクトに関連付ける必要があります。プロジェクト ID の確認方法については、プロジェクト名、番号、ID を確認するをご覧ください。
Google からの最新情報を受け取るデベロッパーの連絡先として指定する、Google アカウントに関連付けられた有効なメールアドレス。サービスアカウントのメールアドレスは指定できません。Merchant Center アカウントにすでに登録されているメールアドレスを使用することも、新しいメールアドレスを使用することもできます。

Merchant API でデベロッパーとして登録する

Merchant API を使用するには、registerGcp メソッドを使用して、デベロッパーの連絡先情報と Google Cloud プロジェクトを Merchant Center アカウントに登録する必要があります。

複数の販売アカウントを使用しているかどうかにかかわらず、使用する Google Cloud プロジェクトごとに登録オペレーションを 1 回実行します。複数の Google Cloud プロジェクトを使用している場合は、その一部またはすべてを同じ Merchant Center アカウントに登録できます。

登録のメリット

登録すると、次のメリットがあります。

技術担当者の作成: Merchant Center で技術担当者を作成します。Google は、サービスに関するお知らせや新機能の情報など、API 固有の重要な更新情報を技術担当者に送信します。
複数の販売アカウントの管理: 管理するすべての販売アカウントのデベロッパーの連絡先として機能できます。

登録を除き、未登録の Google Cloud プロジェクトから Merchant API への呼び出しはブロックされ、ステータス UNAUTHENTICATED と次のエラーメッセージを含む 401 エラーコードが返されます。

GCP project with id {GCP_ID} and number {GCP_NUMBER} is not registered with the merchant account.
Follow these steps https://developers.google.com/merchant/api/guides/quickstart#register_as_a_developer
to register the GCP project with the merchant account then try calling the API again in 5 minutes.

重要な考慮事項

Google Cloud プロジェクトごとの 1 回限りの設定: 登録は Google Cloud プロジェクトごとに 1 回限りの設定であり、Google Cloud プロジェクト内のすべてのユーザーとサービスアカウントに適用されます。Google Cloud プロジェクトで Merchant API が有効になっていることを確認します。
各 Google Cloud プロジェクトは、一度に 1 つの Merchant Center アカウントにのみ登録できます。1 つの Google Cloud プロジェクトを複数の Merchant Center アカウントに同時に登録しようとすると、ALREADY_REGISTERED エラーが発生します。登録には、同じデベロッパーのメールアドレスを使用してください。複数の Google Cloud プロジェクトを同じ Merchant Center アカウントに登録できます。登録済みの Google Cloud プロジェクトを変更またはローテーションする手順については、Google Cloud プロジェクトを管理して移行するをご覧ください。

複数の販売者を管理するサードパーティ（3P）に適切なアカウントを指定する: 長期的な安定性を確保し、サービスの中断を回避するため、複数の販売者を代表または管理するサードパーティは、Google エコシステム内で適切なアカウント構造を使用する必要があります。ビジネスの種類に応じて、ビジネスの身元を表すアカウントを登録することをおすすめします。

既存のアドバンスアカウントを持つマーケットプレイス: ビジネスがマーケットプレイスとして運営されており、プラットフォーム全体を表すアドバンスアカウントがすでにある場合は、この既存のアカウント ID を使用する必要があります。
ショッピング比較サービス（CSS）: CSS の場合は、固有の CSS アカウント ID または CSS グループアカウント ID を使用する必要があります。
代理店、デベロッパー、その他のサードパーティ: 代理店やサードパーティデベロッパーなどのサードパーティビジネスで、複数の販売アカウントを管理しており、ビジネスを表す単一の Merchant Center ID がない場合は、新しいメインの Merchant Center アカウントを作成し、アドバンスアカウントへの変換をリクエストする必要があります。アドバンスアカウントでは、サブアカウントを管理し、サードパーティのオペレーションに必要な構造を提供できます。

次の表に、パートナータイプごとの推奨事項を示します。

パートナータイプ	登録が推奨されるアカウント
ショッピングモール	メインの（または最大の）アドバンスアカウント。
広告代理店	会社を表す独立アカウントまたはアドバンスアカウント。Merchant API を初めて使用する場合は、独立アカウントを作成することをおすすめします。
ショッピング比較サービス（CSS）	CSS グループアカウント ID または特定の CSS アカウント ID（アカウントが CSS グループ全体を表すか、グループ内の特定の CSS のみを表すかによって異なります）。CSS アドバンスアカウントは使用しないでください。
販売者またはブランド	ブランドを表すメインのアカウント。スタンドアロンアカウントまたはアドバンスアカウント。
POS / 在庫データプロバイダ	メインの（または最大の）アドバンスアカウント。
その他のサードパーティ	Merchant Center アカウントをお持ちの場合は、そのアカウントを使用して登録できます。それ以外の場合は、会社の独立アカウントを作成します。次に、ウェブサイトの所有権を証明します。

メインの Merchant Center のみ登録する: メインの Merchant Center アカウントのみを使用してデベロッパー登録を行い、リンクされたすべての Merchant Center サブアカウントのデベロッパー連絡先になります。Merchant Center のサブアカウントごとに登録を行わないでください。

ユーザー補助用の代替テキスト

上の図は、複数の Google Cloud プロジェクトと 1 つのメインの Merchant Center を使用し、必要に応じて複数の Merchant Center サブアカウントを使用する場合の登録設定を示しています。

認証要件: 登録を行う場合、認証済みの Merchant Center アカウント（認証情報が存在するアカウント）は、権限を借用した Merchant Center アカウント（登録するアカウント）と一致する必要があります。別の親アカウントまたはマネージャーアカウントで認証されている場合、サブアカウントに登録することはできません。
所有権が証明されたウェブサイトのアカウントのみ: 登録できるのは、所有権が証明されたウェブサイトを持つ Merchant Center アカウントのみです。
テストアカウントの登録は不可: テストアカウントの登録はできません。
デベロッパーのメールアドレスを登録すると、次のようになります。
- 登録後 5 分以内に Merchant API 呼び出しを実行できます。
- メールアドレスが既存の Merchant Center ユーザーのものである場合は、API developer ロールが付与されます。それ以外の場合は、Merchant Center で新しいユーザーが作成されます。このユーザーは、招待状の有効期限が切れて登録プロセスをやり直す必要がないように、14 日以内に招待を承諾する必要があります。登録プロセスは、ユーザーが招待リンクをクリックした後にのみ完了します。

登録呼び出しを行う

登録するには、registerGcp メソッドを呼び出します。登録呼び出しを行うには、次の 2 つの方法があります。

オプション 1: 直接 API 呼び出し。通常は HTTP(S) 経由で、API エンドポイントに直接未加工のリクエストを送信します。リクエスト本文の作成、ヘッダーの設定（認証を含む）、レスポンスの解析などの処理を手動で行います。
オプション 2: クライアントライブラリ。Merchant API を操作するためのより便利で言語に固有の方法を提供する、事前構築済みのライブラリを使用します。認証と認可を処理し、基盤となる HTTP 通信を抽象化する便利な方法を提供します。すぐに使用を開始できるように、公式のコードサンプルが用意されています。

登録呼び出しの承認

Merchant API へのリクエストを承認するステップで説明したように、認証シナリオは 2 つあります。

OAuth 2.0: 複数の販売アカウントを管理するサードパーティプロバイダまたは代理店向け
サービスアカウント: 独自の Merchant Center アカウントにアクセスする場合

登録呼び出しの認可の詳細については、登録呼び出しの認証と認可を行うにはどうすればよいですか？をご覧ください。

登録コール

次の例では、直接 API 呼び出しまたはクライアントライブラリを使用して登録呼び出しを行います。

登録呼び出しは、registerGcp メソッドを使用して行います。

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp
Content-Type: application/json
Authorization: Bearer {ACCESS_TOKEN}"

{
  "developerEmail": "{DEVELOPER_EMAIL}"
}

次のように置き換えます。

ACCOUNT_ID: Merchant Center ID
ACCESS_TOKEN: API 呼び出しを行うための認証トークン
DEVELOPER_EMAIL: メインの技術担当者のメールアドレス

呼び出しが成功すると、DeveloperRegistration リソースが返され、リンクが成功したことが確認されます。

  "name": "accounts/{ACCOUNT_ID}/developerRegistration",
  "gcpIds": ["{GOOGLE_CLOUD_PROJECT_ID}"]

Python

サンプルをダウンロードし、Google Merchant API Python サンプルのガイダンスに沿って Python クライアントライブラリを設定します。

from examples.authentication import configuration
from examples.authentication import generate_user_credentials
from google.shopping.merchant_accounts_v1 import DeveloperRegistration
from google.shopping.merchant_accounts_v1 import DeveloperRegistrationServiceClient
from google.shopping.merchant_accounts_v1 import RegisterGcpRequest


def register_gcp(
    account_id: str, developer_email: str
) -> DeveloperRegistration:
  """Registers the GCP project used to call the Merchant API with a developer email.

  Args:
    account_id: The ID of your Merchant Center account.
    developer_email: The email address of the developer to register.

  Returns:
    The created or updated DeveloperRegistration object.
  """
  # Get OAuth credentials.
  credentials = generate_user_credentials.main()

  # Create a client to the Developer Registration Service.
  client = DeveloperRegistrationServiceClient(credentials=credentials)

  # The name has the format: accounts/{account}/developerRegistration
  name = f"accounts/{account_id}/developerRegistration"

  # Create the request to register the GCP project.
  request = RegisterGcpRequest(
      name=name,
      developer_email=developer_email,
  )

  # Make the API call and handle potential errors.
  try:
    print("Sending RegisterGcp request:")
    response = client.register_gcp(request=request)
    print("Registered GCP project successfully:")
    print(response)
    return response
  except RuntimeError as e:
    print(f"An error occurred: {e}")
    raise


if __name__ == "__main__":

  # Your Merchant Center account ID.
  # This can be found in the Merchant Center UI.
  _account_id = configuration.Configuration().read_merchant_info()

  # The developer email to associate with the GCP project.
  _developer_email = "YOUR_EMAIL_HERE"

  register_gcp(_account_id, _developer_email)register_gcp_sample.py

Java

サンプルをダウンロードし、Google Merchant API Java サンプルのガイダンスに沿って Java クライアントライブラリを設定します。

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1.DeveloperRegistration;
import com.google.shopping.merchant.accounts.v1.DeveloperRegistrationName;
import com.google.shopping.merchant.accounts.v1.DeveloperRegistrationServiceClient;
import com.google.shopping.merchant.accounts.v1.DeveloperRegistrationServiceSettings;
import com.google.shopping.merchant.accounts.v1.RegisterGcpRequest;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/**
 * This class demonstrates how to register the GCP project used to call the Merchant API with a
 * developer email.
 */
public class RegisterGcpSample {

  public static DeveloperRegistration registerGcp(Config config, String developerEmail) throws Exception {

    // Obtains OAuth token based on the user's configuration.
    GoogleCredentials credential = new Authenticator().authenticate();

    // Creates service settings using the credentials retrieved above.
    DeveloperRegistrationServiceSettings developerRegistrationServiceSettings =
        DeveloperRegistrationServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    // Creates DeveloperRegistration name to identify the DeveloperRegistration.
    // The name has the format: accounts/{account}/developerRegistration
    String name =
        DeveloperRegistrationName.newBuilder()
            .setAccount(config.getAccountId().toString())
            .build()
            .toString();

    // Calls the API and propagates any network failures/errors.
    try (DeveloperRegistrationServiceClient developerRegistrationServiceClient =
        DeveloperRegistrationServiceClient.create(developerRegistrationServiceSettings)) {

      // Creates a request to register the GCP project with the developer email.
      RegisterGcpRequest request =
          RegisterGcpRequest.newBuilder().setName(name).setDeveloperEmail(developerEmail).build();

      System.out.println("Sending RegisterGcp request:");
      DeveloperRegistration response = developerRegistrationServiceClient.registerGcp(request);

      System.out.println(response);
      return response;
    }
  }

  public static void main(String[] args) throws Exception {
    Config config = Config.load();
    String developerEmail = "YOUR_EMAIL_HERE"; // Replace with your email
    registerGcp(config, developerEmail);
  }
}RegisterGcpSample.java

PHP

サンプルをダウンロードし、Google Merchant API PHP サンプルのガイダンスに沿って PHP クライアントライブラリを設定します。

require_once __DIR__ . '/../../../../vendor/autoload.php';
require_once __DIR__ . '/../../../Authentication/Authentication.php';
require_once __DIR__ . '/../../../Authentication/Config.php';

use Google\ApiCore\ApiException;
use Google\Shopping\Merchant\Accounts\V1\Client\DeveloperRegistrationServiceClient;
use Google\Shopping\Merchant\Accounts\V1\RegisterGcpRequest;

/**
 * This class demonstrates how to register the GCP project used to call the
 * Merchant API with a developer email.
 */
class RegisterGcpSample
{
    /**
     * A helper function to create the name string for the
     * DeveloperRegistration.
     *
     * @param string $accountId The merchant account ID.
     * @return string The name, which has the format:
     *     `accounts/{account}/developerRegistration`
     */
    private static function getName(string $accountId): string
    {
        return sprintf("accounts/%s/developerRegistration", $accountId);
    }

    /**
     * Registers the GCP project with a developer email.
     *
     * @param array $config The configuration data for authentication and account ID.
     * @param string $developerEmail The email of the developer to register.
     */
    public static function registerGcpSample(array $config, string $developerEmail): void
    {
        // Obtains OAuth credentials from the configuration file.
        $credentials = Authentication::useServiceAccountOrTokenFile();

        // Creates a configuration object for the client.
        $options = ['credentials' => $credentials];

        // Creates the DeveloperRegistrationServiceClient.
        $developerRegistrationServiceClient = new DeveloperRegistrationServiceClient($options);

        // Creates the name of the developer registration to identify it.
        $name = self::getName($config['accountId']);

        // Calls the API and handles any network failures.
        try {
            // Creates a request to register the GCP project with the developer email.
            $request = new RegisterGcpRequest([
                'name' => $name,
                'developer_email' => $developerEmail
            ]);

            printf("Sending RegisterGcp request:%s", PHP_EOL);
            // The `registerGcp` method returns a `DeveloperRegistration` object
            // upon success.
            $response = $developerRegistrationServiceClient->registerGcp($request);
            print "Successfully registered developer email '$developerEmail' for account {$config['accountId']}.\n";
            print_r($response);
        } catch (ApiException $e) {
            printf("An error occurred: %s%s", $e->getMessage(), PHP_EOL);
        }
    }

    /**
     * Helper to execute the sample.
     */
    public function callSample(): void
    {
        $config = Config::generateConfig();
        // An email address for a developer to register for the API.
        $developerEmail = 'YOUR_EMAIL_HERE'; // Replace with your email
        self::registerGcpSample($config, $developerEmail);
    }
}

// Executes the sample.
$sample = new RegisterGcpSample();
$sample->callSample();RegisterGcpSample.php

cURL

curl -X POST "https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {ACCESS_TOKEN}" \
-d '{
  "developerEmail": "{DEVELOPER_EMAIL}"
}'

登録を完了するには、Merchant Center の少なくとも 1 人のユーザーに API developer ロールが割り当てられていることを確認する必要があります。これを行うには、次のいずれかの操作を行います。

developerEmail を registerGcp メソッドに渡します。
Merchant Center UI で API developer ロールを持つ新しいユーザーを追加します。
Merchant Center UI で、既存のユーザーに API developer ロールを割り当てます。
accounts.users.create メソッドを呼び出して新規ユーザーを作成し、API developer ロールを割り当てます。
accounts.users.patch メソッドを使用して、既存のユーザーに API developer ロールを割り当てます。

登録後のベストプラクティス

堅牢なアクセス管理のメリットを享受し、将来のサービスの中断を防ぐため、初期登録の完了後に一連のベストプラクティスに従うことをおすすめします。

`API developer` に追加の権限を付与する

デベロッパーの連絡先を登録すると、API developer ロールが自動的に割り当てられます。このロールには、Merchant Center アカウントの管理や、すべての API 呼び出しに必要なその他の権限は含まれていません。包括的なアクセス権を付与するには、ADMIN ロールまたは STANDARD ロールをデベロッパーに追加することをおすすめします。

ユーザーのアクセス権を変更するには、accounts.users.patch メソッドを使用します。リクエスト本文の updateMask フィールドにアクセス権を指定して、ロールを追加または削除します。

PATCH https://merchantapi.googleapis.com/accounts/v1/{ACCOUNT_ID}/users/{DEVELOPER_EMAIL}?update_mask=access_rights
Content-Type: application/json
Authorization: Bearer {ACCESS_TOKEN}"

{
  "name": "accounts/{ACCOUNT_ID}/users/{DEVELOPER_EMAIL}",
  "access_rights": [ "ADMIN", "API_DEVELOPER" ]
}

Python

from examples.authentication import configuration
from examples.authentication import generate_user_credentials
from google.protobuf import field_mask_pb2
from google.shopping.merchant_accounts_v1 import AccessRight
from google.shopping.merchant_accounts_v1 import UpdateUserRequest
from google.shopping.merchant_accounts_v1 import User
from google.shopping.merchant_accounts_v1 import UserServiceClient

FieldMask = field_mask_pb2.FieldMask

_ACCOUNT = configuration.Configuration().read_merchant_info()


def update_user(user_email, user_access_right):
  """Updates a user to make it an admin of the MC account."""

  credentials = generate_user_credentials.main()

  client = UserServiceClient(credentials=credentials)

  # Create user name string
  name = "accounts/" + _ACCOUNT + "/users/" + user_email

  user = User(name=name, access_rights=[user_access_right])

  field_mask = FieldMask(paths=["access_rights"])

  try:
    request = UpdateUserRequest(user=user, update_mask=field_mask)

    print("Sending Update User request")
    response = client.update_user(request=request)
    print("Updated User Name below")
    print(response.name)
  except RuntimeError as e:
    print(e)


if __name__ == "__main__":
  # Modify this email to update the right user
  email = "USER_MAIL_ACCOUNT"
  access_right = AccessRight.ADMIN
  update_user(email, access_right)
update_user_sample.py

Java

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.protobuf.FieldMask;
import com.google.shopping.merchant.accounts.v1.AccessRight;
import com.google.shopping.merchant.accounts.v1.UpdateUserRequest;
import com.google.shopping.merchant.accounts.v1.User;
import com.google.shopping.merchant.accounts.v1.UserName;
import com.google.shopping.merchant.accounts.v1.UserServiceClient;
import com.google.shopping.merchant.accounts.v1.UserServiceSettings;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to update a user to make it an admin of the MC account. */
public class UpdateUserSample {

  public static void updateUser(Config config, String email, AccessRight accessRight)
      throws Exception {

    GoogleCredentials credential = new Authenticator().authenticate();

    UserServiceSettings userServiceSettings =
        UserServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    // Creates user name to identify user.
    String name =
        UserName.newBuilder()
            .setAccount(config.getAccountId().toString())
            .setEmail(email)
            .build()
            .toString();

    // Create a user with the updated fields.
    User user = User.newBuilder().setName(name).addAccessRights(accessRight).build();

    FieldMask fieldMask = FieldMask.newBuilder().addPaths("access_rights").build();

    try (UserServiceClient userServiceClient = UserServiceClient.create(userServiceSettings)) {

      UpdateUserRequest request =
          UpdateUserRequest.newBuilder().setUser(user).setUpdateMask(fieldMask).build();

      System.out.println("Sending Update User request");
      User response = userServiceClient.updateUser(request);
      System.out.println("Updated User Name below");
      System.out.println(response.getName());
    } catch (Exception e) {
      System.out.println(e);
    }
  }

  public static void main(String[] args) throws Exception {
    Config config = Config.load();
    String email = "testUser@gmail.com";
    // Give the user admin rights. Note that all other rights, like
    // PERFORMANCE_REPORTING, would be overwritten in this example
    // if the user had those access rights before the update.
    AccessRight accessRight = AccessRight.ADMIN;

    updateUser(config, email, accessRight);
  }
}UpdateUserSample.java

PHP

use Google\ApiCore\ApiException;
use Google\Protobuf\FieldMask;
use Google\Shopping\Merchant\Accounts\V1\AccessRight;
use Google\Shopping\Merchant\Accounts\V1\UpdateUserRequest;
use Google\Shopping\Merchant\Accounts\V1\User;
use Google\Shopping\Merchant\Accounts\V1\Client\UserServiceClient;


/**
 * Updates a user.
 *
 * @param array $config The configuration data.
 * @param string $email The email address of the user.
 * @param int $accessRight The access right to grant the user.
 * @return void
 */
function updateUser($config, $email, $accessRights): void
{
    // Gets the OAuth credentials to make the request.
    $credentials = Authentication::useServiceAccountOrTokenFile();

    // Creates options config containing credentials for the client to use.
    $options = ['credentials' => $credentials];

    // Creates a client.
    $userServiceClient = new UserServiceClient($options);

    // Creates user name to identify user.
    $name = 'accounts/' . $config['accountId'] . "/users/" . $email;

    $user = (new User())
        ->setName($name)
        ->setAccessRights($accessRights);

    $fieldMask = (new FieldMask())->setPaths(['access_rights']);

    // Calls the API and catches and prints any network failures/errors.
    try {
        $request = new UpdateUserRequest([
            'user' => $user,
            'update_mask' => $fieldMask,
        ]);

        print "Sending Update User request\n";
        $response = $userServiceClient->updateUser($request);
        print "Updated User Name below\n";
        print $response->getName() . "\n";
    } catch (ApiException $e) {
        print $e->getMessage();
    }
}


$config = Config::generateConfig();
$email = "testUser@gmail.com";
$accessRights = [AccessRight::ADMIN];

updateUser($config, $email, $accessRights);UpdateUserSample.php

cURL

curl -X PATCH \
"https://merchantapi.googleapis.com/accounts/v1/{ACCOUNT_ID}/users/{USER_EMAIL}?update_mask=access_rights" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {ACCESS_TOKEN}" \
-d '{
  "access_rights": [
    "ADMIN",
    "API_DEVELOPER"
  ]
}'

デベロッパーの連絡先を追加する

メインのデベロッパーの連絡先が退職したり、アクセス権を失ったりした場合にビジネスが中断しないように、連絡先を冗長化しておくことが重要です。Merchant Center で API developer ロールを持つユーザーを少なくとも 1 人追加して、バックアップとして機能させることをおすすめします。

ユーザーを追加したり、既存のユーザーを更新したりするには、Merchant API の accounts.users サービスまたは Merchant Center UI の [アクセスとサービス] ページを使用します。バックアップデベロッパーを事前に追加することで、1 人の個人に依存しない、より復元力のある統合を作成できます。

PATCH https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/users
Content-Type: application/json
Authorization: Bearer {ACCESS_TOKEN}"
{
  "user_id": {USER_EMAIL},
  "user": { "access_rights": [ "API_DEVELOPER", "ADMIN" ] }
}

Python

from examples.authentication import configuration
from examples.authentication import generate_user_credentials
from google.shopping.merchant_accounts_v1 import AccessRight
from google.shopping.merchant_accounts_v1 import CreateUserRequest
from google.shopping.merchant_accounts_v1 import User
from google.shopping.merchant_accounts_v1 import UserServiceClient

_ACCOUNT = configuration.Configuration().read_merchant_info()


def get_parent(account_id):
  return f"accounts/{account_id}"


def create_user(user_email):
  """Creates a user for a Merchant Center account."""

  # Get OAuth credentials
  credentials = generate_user_credentials.main()

  # Create a UserServiceClient
  client = UserServiceClient(credentials=credentials)

  # Create parent string
  parent = get_parent(_ACCOUNT)

  # Create the request
  request = CreateUserRequest(
      parent=parent,
      user_id=user_email,
      user=User(
          access_rights=[AccessRight.ADMIN, AccessRight.PERFORMANCE_REPORTING]
      ),
  )

  try:
    print("Sending Create User request")
    response = client.create_user(request=request)
    print("Inserted User Name below")
    print(response.name)
  except RuntimeError as e:
    print(e)


if __name__ == "__main__":
  # Modify this email to create a new user
  email = "USER_MAIL_ACCOUNT"
  create_user(email)
create_user_sample.py

Java

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1.AccessRight;
import com.google.shopping.merchant.accounts.v1.CreateUserRequest;
import com.google.shopping.merchant.accounts.v1.User;
import com.google.shopping.merchant.accounts.v1.UserServiceClient;
import com.google.shopping.merchant.accounts.v1.UserServiceSettings;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to create a user for a Merchant Center account. */
public class CreateUserSample {

  private static String getParent(String accountId) {
    return String.format("accounts/%s", accountId);
  }

  public static void createUser(Config config, String email) throws Exception {

    // Obtains OAuth token based on the user's configuration.
    GoogleCredentials credential = new Authenticator().authenticate();

    // Creates service settings using the credentials retrieved above.
    UserServiceSettings userServiceSettings =
        UserServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    // Creates parent to identify where to insert the user.
    String parent = getParent(config.getAccountId().toString());

    // Calls the API and catches and prints any network failures/errors.
    try (UserServiceClient userServiceClient = UserServiceClient.create(userServiceSettings)) {

      CreateUserRequest request =
          CreateUserRequest.newBuilder()
              .setParent(parent)
              // This field is the email address of the user.
              .setUserId(email)
              .setUser(
                  User.newBuilder()
                      .addAccessRights(AccessRight.ADMIN)
                      .addAccessRights(AccessRight.PERFORMANCE_REPORTING)
                      .build())
              .build();

      System.out.println("Sending Create User request");
      User response = userServiceClient.createUser(request);
      System.out.println("Inserted User Name below");
      // The last part of the user name will be the email address of the user.
      // Format: `accounts/{account}/user/{user}`
      System.out.println(response.getName());
    } catch (Exception e) {
      System.out.println(e);
    }
  }

  public static void main(String[] args) throws Exception {
    Config config = Config.load();
    // The email address of this user.
    String email = "testUser@gmail.com";

    createUser(config, email);
  }
}CreateUserSample.java

PHP

use Google\ApiCore\ApiException;
use Google\Shopping\Merchant\Accounts\V1\AccessRight;
use Google\Shopping\Merchant\Accounts\V1\CreateUserRequest;
use Google\Shopping\Merchant\Accounts\V1\User;
use Google\Shopping\Merchant\Accounts\V1\Client\UserServiceClient;


/**
 * Creates a user.
 *
 * @param array $config The configuration data.
 * @param string $email The email address of the user.
 * @return void
 */
function createUser($config, $email): void
{
    // Gets the OAuth credentials to make the request.
    $credentials = Authentication::useServiceAccountOrTokenFile();

    // Creates options config containing credentials for the client to use.
    $options = ['credentials' => $credentials];

    // Creates a client.
    $userServiceClient = new UserServiceClient($options);

    // Creates parent to identify where to insert the user.
    $parent = sprintf("accounts/%s", $config['accountId']);

    // Calls the API and catches and prints any network failures/errors.
    try {
        $request = new CreateUserRequest([
            'parent' => $parent,
            'user_id' => $email,
            'user' => (new User())
                ->setAccessRights([AccessRight::ADMIN,AccessRight::PERFORMANCE_REPORTING])
        ]);

        print "Sending Create User request\n";
        $response = $userServiceClient->createUser($request);
        print "Inserted User Name below\n";
        print $response->getName() . "\n";
    } catch (ApiException $e) {
        print $e->getMessage();
    }
}

$config = Config::generateConfig();
$email = "testUser@gmail.com";

createUser($config, $email);CreateUserSample.php

cURL

curl -X PATCH \
"https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/users/{USER_EMAIL}?update_mask=access_rights" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {ACCESS_TOKEN}" \
-d '{
  "access_rights": [
    "ADMIN",
    "API_DEVELOPER"
  ]
}'

Set up authentication

Insert your first product

デベロッパーとして登録 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

前提条件

Merchant API でデベロッパーとして登録する

登録のメリット

重要な考慮事項

登録呼び出しを行う

登録呼び出しの承認

登録コール

Python

Java

PHP

cURL

登録後のベスト プラクティス

API developer に追加の権限を付与する

Python

Java

PHP

cURL

デベロッパーの連絡先を追加する

Python

Java

PHP

cURL

デベロッパーとして登録

登録後のベストプラクティス

`API developer` に追加の権限を付与する