Accounts API を使用すると、Merchant Center アカウントと他のサービス提供者との関係を管理できます。関係とは、プロバイダがビジネスに特定のサービスを提供できるようにする正式な接続です。サービスは、商品管理やキャンペーン管理など、プロバイダに付与される権限と機能を定義します。たとえば、Merchant Center アカウントを Google 広告アカウントにリンクすると、広告アカウントで商品データを使用して広告キャンペーンを運用できるようになります。
関係は次の属性で構成されます。
- サービスを受ける Merchant Center アカウント
- サービス提供者
- Merchant Center アカウントに提供されているサービスまたはサービスセット
エイリアス
サービス提供者は、サービスを提供するアカウントにエイリアスを関連付けることができます（これは、Content API for Shopping の account リソースに存在する seller_id フィールドに相当します）。エイリアスは、AccountRelationship リソース内のオプションの account_id_alias フィールドを使用して割り当てることができ、カスタム識別子として機能します。エイリアスは、ASCII 文字、10 進数字、ハイフン、アンダースコア、ピリオド、チルダ（[A-Za-z0-9_~.-]{1,50}）から選択した 1 ～ 50 文字で構成する必要があります。
エイリアスを使用してアカウントにアクセスするための URL 構造は GET /accounts/v1/accounts/{provider}~{account_id_alias} です。
サービス
Accounts API では、アカウントは次のサービスを受け取ることができます。これらのサービスの多くは、アカウントの作成時に追加できます。
アカウントの集約: このサービス（
accountAggregation）は、マルチクライアント アドバンス アカウントをサブアカウントにリンクし、アドバンス アカウントに完全な無制限のアクセス権を付与して、サブアカウントを Merchant Center UI に表示します。Merchant Center の UI では、新しいサブアカウントを作成する際に、ストアビルダー（e コマース プラットフォーム）、チャネル パートナー、ショッピングモール、マルチブランドの小売店、海外の小売店のアカウントがaccountAggregationを使用してアドバンス アカウントに自動的に変換されます。代理店の場合は、代わりにaccountManagementを使用してください。アカウント集約を使用してアカウントを作成する場合は、externalAccountIdを省略する必要があります。キャンペーン管理: このサービスは、Merchant Center アカウントと Google 広告アカウントのリンクをモデル化し、広告キャンペーンの実施に必要な商品データとアカウント データへのアクセス権を Google 広告アカウントに付与します。この場合のサービス プロバイダは
GOOGLE_ADSで、externalAccountIdは Google 広告アカウントの ID です。このサービスは、既存のアカウントに提案することもできます。
- このサービスを使用すると、コマース メディア ネットワーク キャンペーンの実施時に、パートナー固有の商品フィルタを作成できます。
- 現時点では、Accounts サブ API のアルファ版を使用する必要があります。
- この機能を使用するには、特定の GMC の許可リストへの登録が必要です。
詳しくは、Google 広告アカウント管理チームにお問い合わせください。
ショッピング比較: Merchant Center アカウントを運営するショッピング比較サービス（CSS）との関係を表します。
ローカル リスティングの管理: Google ビジネス プロフィールを使用してローカル在庫とリスティングを管理する店舗マネージャーとの関係を表します。
アカウント管理: このサービス（
accountManagement）を使用すると、プロバイダは、アカウント設定の構成、ユーザーの管理、ビジネス情報の更新など、スタンドアロンの外部 Merchant Center アカウントで管理アクションを実行できます。企業は、付与されたアクセス権を制限することもできます。アカウントの作成時に使用すると、このサービスはプロバイダにリンクされた独立アカウントを作成します。既存のアカウントに提案することもできます。このサービスタイプを使用する代理店は、代理店向け Merchant Center で管理しているアカウントを確認できます。ストア ビルダーとチャネル パートナーは、Merchant API を使用して、accountManagementを通じて管理している販売者に関する情報を取得できます。プロダクト管理: このサービスを使用すると、プロバイダはプロダクトと、データソースやルールなどの関連機能を管理できます。アカウントの作成時に追加する場合は、通常、
accountManagementまたはaccountAggregationと組み合わせて使用します。このサービスは、既存のアカウントに提案することもできます。UCP 購入手続きの管理（
v1alpha、アクセス制限あり）:ucpCheckoutManagementサービスを使用すると、承認されたサービス提供者が販売者に代わって UCP 購入手続きの統合、設定、プログラムへの参加を管理できます。このサービスは、既存の Merchant Center アカウントにのみ提案または承認できます。注: UCP 購入手続きは、アクセスが制限されたアルファ版機能です。サービス提供者と UCP の購入手続きの詳細については、サービス提供者向けの Merchant Center をご覧ください。
握手
サービスを確立するには、サービスを提供するアカウントとサービスを受けるアカウントの両方が接続を承認する必要があります。この承認プロセスは ハンドシェイクと呼ばれます
ハンドシェイクは 2 段階のプロセスです。
- 一方の当事者がサービスリンクを提案します。
- 相手が提案を承認または拒否します。
提案が承認されると、サービスが承認され、完全に確立されたと見なされます。サービス提供者に付与されたアクセス権は、対象となるユーザーに付与されるようになりました（下記のアクセス権をご覧ください）。
プロポーザルを作成、拒否、承認するユーザーは、プロセスを開始するアカウントに対する ADMIN アクセス権を持っている必要があります。したがって、サービス提供者がサービスを提案する場合、提案を行うユーザーはサービス提供者のアカウントの ADMIN である必要があります。また、提案を承認または拒否するユーザーは、受信側のアカウントの ADMIN である必要があります。
次のサンプルは、アカウント サービスを提案する方法を示しています。
Java
import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1.AccountName;
import com.google.shopping.merchant.accounts.v1.AccountService;
import com.google.shopping.merchant.accounts.v1.AccountServicesServiceClient;
import com.google.shopping.merchant.accounts.v1.AccountServicesServiceSettings;
import com.google.shopping.merchant.accounts.v1.ProductsManagement;
import com.google.shopping.merchant.accounts.v1.ProposeAccountServiceRequest;
import shopping.merchant.samples.utils.Authenticator;
/** This class demonstrates how to propose a service to an existing Merchant Center account. */
public class ProposeServiceSample {
public static void proposeService(long accountId, long providerId, String externalAccountId)
throws Exception {
// Obtains OAuth token based on the user's configuration.
// The user that authenticates should have access to the account.
GoogleCredentials credential = new Authenticator().authenticate();
// Creates service settings using the credentials retrieved above.
AccountServicesServiceSettings accountServicesServiceSettings =
AccountServicesServiceSettings.newBuilder()
.setCredentialsProvider(FixedCredentialsProvider.create(credential))
.build();
// Calls the API and catches and prints any network failures/errors.
try (AccountServicesServiceClient accountServicesServiceClient =
AccountServicesServiceClient.create(accountServicesServiceSettings)) {
// The service to be proposed.
// This sample shows how to propose product management.
// For more information about the different services, see:
// https://developers.google.com/merchant/api/guides/accounts/services
AccountService accountService =
AccountService.newBuilder()
.setProductsManagement(ProductsManagement.newBuilder().build())
.setExternalAccountId(externalAccountId)
.build();
String accountName =
AccountName.newBuilder().setAccount(String.valueOf(accountId)).build().toString();
ProposeAccountServiceRequest request =
ProposeAccountServiceRequest.newBuilder()
.setParent(accountName)
.setProvider("accounts/" + providerId)
.setAccountService(accountService)
.build();
System.out.println("Sending Propose Service request:");
AccountService response = accountServicesServiceClient.proposeAccountService(request);
System.out.println("Proposed Service below");
System.out.println(response);
} catch (Exception e) {
System.out.println(e);
}
}
public static void main(String[] args) throws Exception {
// The ID of the account to propose the service to.
long accountId = 123L;
// This is the provider ID of the e-commerce platform.
long providerId = 456L;
// An external ID that uniquely identifies the account service.
String externalAccountId = "ext-acc-id-123";
proposeService(accountId, providerId, externalAccountId);
}
}
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\AccountAggregation;
use Google\Shopping\Merchant\Accounts\V1\AccountService;
use Google\Shopping\Merchant\Accounts\V1\Client\AccountServicesServiceClient;
use Google\Shopping\Merchant\Accounts\V1\ProposeAccountServiceRequest;
/**
* This class demonstrates how to propose an account service.
*/
class ProposeAccountServiceSample
{
/**
* A helper function to create the account name string.
*
* @param string $accountId The ID of the account.
*
* @return string The account name has the format: `accounts/{account_id}`
*/
private static function toAccountName(string $accountId): string
{
return sprintf('accounts/%s', $accountId);
}
/**
* Proposes a new account service.
*
* @param array $config The configuration data used for authentication and
* getting the account ID.
* @param string $providerId The ID of the provider account.
*/
public static function proposeAccountService(
array $config,
string $providerId
): void {
// Gets the OAuth credentials to make the request.
$credentials = Authentication::useServiceAccountOrTokenFile();
// Creates options containing credentials for the client to use.
$options = ['credentials' => $credentials];
// Creates a client.
$accountServicesServiceClient = new AccountServicesServiceClient($options);
// Calls the API and catches and prints any network failures/errors.
try {
$accountAggregation = new AccountAggregation();
$accountService = (new AccountService())
->setAccountAggregation($accountAggregation);
$request = (new ProposeAccountServiceRequest())
->setParent(self::toAccountName($config['accountId']))
->setProvider(self::toAccountName($providerId))
->setAccountService($accountService);
print "Sending Propose AccountService request\n";
$response = $accountServicesServiceClient->proposeAccountService($request);
print "Proposed AccountService below\n";
print $response->serializeToJsonString(true) . PHP_EOL;
} catch (ApiException $e) {
printf("An error has occurred: %s%s", $e->getMessage(), PHP_EOL);
}
}
/**
* Helper to execute the sample.
*/
public function callSample(): void
{
$config = Config::generateConfig();
// Update this with the Merchant Center provider ID you want to get the
// relationship for.
$providerId = 111;
self::proposeAccountService($config, $providerId);
}
}
// Run the script
$sample = new ProposeAccountServiceSample();
$sample->callSample();
Python
"""This class demonstrates how to propose an account service."""
from examples.authentication import configuration
from examples.authentication import generate_user_credentials
from google.shopping.merchant_accounts_v1 import AccountAggregation
from google.shopping.merchant_accounts_v1 import AccountService
from google.shopping.merchant_accounts_v1 import AccountServicesServiceClient
from google.shopping.merchant_accounts_v1 import ProposeAccountServiceRequest
_ACCOUNT = configuration.Configuration().read_merchant_info()
_PARENT = f"accounts/{_ACCOUNT}"
def propose_account_service(provider_id: int) -> None:
"""Proposes an account service.
Args:
provider_id: The Merchant Center ID of the provider.
"""
# Gets OAuth Credentials.
credentials = generate_user_credentials.main()
# Creates a client.
client = AccountServicesServiceClient(credentials=credentials)
# Creates the provider resource name from the provider ID.
provider = f"accounts/{provider_id}"
# Creates an AccountService object.
# For this request, only `account_aggregation` is needed.
account_service = AccountService()
account_service.account_aggregation = AccountAggregation()
# Creates the request.
request = ProposeAccountServiceRequest(
parent=_PARENT,
provider=provider,
account_service=account_service,
)
# Makes the request and catches and prints any error messages.
try:
print("Sending Propose AccountService request")
response = client.propose_account_service(request=request)
print("Proposed AccountService below")
print(response)
except RuntimeError as e:
print(e)
if __name__ == "__main__":
# Update this with the Merchant Center provider ID you want to get the
# relationship for.
provider_id_ = 111
propose_account_service(provider_id_)
サービス固有のハンドシェイクの動作
以下は、個々のサービスに固有のハンドシェイク要件の説明です。
アカウント集約: このサービスは、アカウント作成の一環としてのみ確立できます。サービス提供者はアドバンス アカウントであることが想定されており、アドバンス アカウントのユーザーは作成されるアカウントに対する完全な
ADMINアクセス権を持っているため、サービスは自動的に承認されます。比較ショッピング: このサービスは、
createAndConfigureを使用してアカウントを作成するときに追加されると、自動的に承認されます。キャンペーン管理: 通常のハンドシェイク プロセスに従いますが、提案は 1 つのシステム（Google 広告など）で行われ、承認は別のシステム（Merchant Center や Merchant API など）で行われます。
ローカル リスティング管理: このサービスでは、ハンドシェイクは専用の方法で提案され、承認は別のシステム（Google ビジネス プロフィールなど）で行われます。詳しい手順については、Google ビジネス プロフィールをリンクするためのガイドをご覧ください。
アカウント管理: このサービスでは、
proposeを使用する場合に通常のハンドシェイク プロセスが適用されます。createAndConfigureを使用してアカウントの作成時にサービスが追加された場合、サービスは自動的に承認されます。プロダクト管理: このサービスには、通常のハンドシェイク プロセス（一方の当事者が提案し、もう一方の当事者が承認する）が適用されます。
UCP 購入手続き管理（
v1alpha、アクセス制限あり）: このサービスでは、販売者はサービス提供者のポータルで Google がホストするアカウント リンク ダイアログを使用するか、標準のハンドシェイク プロセス（proposeの後にapprove）を使用してハンドシェイクを完了できます。統合の詳細については、Merchant Center サービス提供者のドキュメントをご覧ください。
アクセス権
各サービスタイプは、サービス プロバイダのユーザーに、サービス対象のアカウントに対する特定のレベルのアクセス権を付与します。
アカウント集約: このサービスは、完全な
ADMIN権限を提供します。キャンペーン管理: このサービスでは、関連付けられた広告アカウントが商品と基本的なアカウント情報にアクセスできるように、制限付きのアクセス権が付与されます。
ショッピング比較: このサービスには、デフォルトで完全な
ADMIN権限が付与されます。ただし、ビジネスは Merchant Center で付与されたアクセス権を制限できます。ローカル リスティングの管理: このサービスには直接アクセス権がありません。代わりに、リスティングで商品を Merchant Center アカウントと同期できるようになります。
重要: 以下のサービスタイプに記載されているアクセス権は、承認済みのサービス提供者にのみ適用されます。サービス提供者で、この機能を利用する場合は、サポートチームにお問い合わせください。Content API for Shopping で商品管理の accounts.link メソッドがすでに承認されている場合は、Merchant API でこのサービスを使用できます。
アカウント管理: このサービスは、デフォルトで完全な
ADMIN権限を提供します。プロダクト管理: このサービスは、完全な
ADMIN権限を提供します。なお、今後は、プロダクト関連のアクセス権のみに制限される予定です。UCP 購入手続き管理（
v1alpha、制限付きアクセス）: このサービスは、完全なADMIN権限を提供します。なお、今後は UCP の購入手続きに関連するアクセス権のみに制限される予定です。
サードパーティ プラットフォームにリレーションシップが適用される仕組み
他のビジネスに代わってアカウントを管理するサードパーティ プラットフォームの場合、さまざまなコンセプトがアカウント構造にどのようにマッピングされるかを以下に示します。
- サービス提供者: アドバンス アカウント。
- サービスを受けるアカウント: 管理するビジネスを表す Merchant Center アカウント。
- サービス:
accountAggregation: 販売者に代わって新しいサブアカウントを作成するストア ビルダー（e コマース プラットフォーム）、チャネル パートナー、ショッピング モール、マルチブランドの小売店で使用されます。Merchant Center の管理画面では、ストア ビルダーとチャネル パートナーがaccountAggregationを持つアドバンス アカウントとして自動的に設定され、Merchant Center の管理画面でサブアカウントを表示、管理できるようになります。accountManagement: 販売者が所有するスタンドアロンのクライアント アカウントを作成またはリンクする代理店が使用します。これらのアカウントは、代理店向け Merchant Center で確認できます。他のタイプのサービス提供者は、Merchant API のaccounts.listメソッドを使用して、リンクされたアカウント情報を表示します。
アドバンス アカウントを設定して新しい Merchant Center アカウントにリンクする方法については、アカウントを作成するをご覧ください。