ユーザーとアクセスの管理を移行する

Content API for Shopping では、Account リソースのフィールドを使用して、ユーザーとそのアクセス権を管理していました。Merchant API では、このフィールドが専用の リソース Userと、 対応するメソッド（create、delete、get、list、path）に置き換えられています。詳しくは、 アカウントへのアクセスを制御するをご覧ください。

主な違い

Content API for Shopping と比較して、Merchant API にはユーザー管理に関して次のような利点があります。

• 専用リソース: Merchant Center アカウントにアクセスできるユーザーとその権限を、よりきめ細かく直接的に 制御できます。
• RESTful リソース名: Merchant API では、User リソースは 完全なリソース名（accounts/12345/users/example@example.com など）で識別されます。
• me エイリアス: リソース名でメールアドレスの代わりにエイリアス me を使用して、認証済みユーザーを参照できます（例: accounts/12345/users/me）。
• 統合されたアクセス権: Merchant API では、Content API のブール値のアクセス フィールド（admin、reportingManager など）が、1 つの繰り返し可能な フィールドに統合されています。access_rights
• ユーザーの招待と確認: Merchant API では、 明示的なユーザーの状態（PENDING または VERIFIED）が導入されています。新しいユーザーを作成すると、 招待を承諾するまで PENDING 状態になります。これにより、Content API for Shopping では利用できなかったユーザーのステータスを API で確認できます。 リクエスト件数を追加##

Merchant API では、次のリクエスト URL を使用してユーザーを管理します。

• GET /accounts/v1/accounts/{account}/users/{email}
• GET /accounts/v1/accounts/{account}/users
• POST /accounts/v1/accounts/{account}/users
• PATCH /accounts/v1/accounts/{account}/users/{email}
• DELETE /accounts/v1/accounts/{account}/users/{email}

次の表に、Content API for Shopping と Merchant API のリクエスト URL を比較します。

リクエストの説明	Content API for Shopping	Merchant API
アカウントのユーザーを取得する	GET {api_version}/{merchantId}/accounts/{accountId}	GET {api_version}/accounts/{account}/users
ユーザーを作成する	PATCH {api_version}/{merchantId}/accounts/{accountId}	POST {api_version}/accounts/{account}/users
ユーザーを更新する	PATCH {api_version}/{merchantId}/accounts/{accountId}	PATCH {api_version}/accounts/{account}/users/{email}
ユーザーを削除する	PATCH {api_version}/{merchantId}/accounts/{accountId}	DELETE {api_version}/accounts/{account}/users/{email}

識別子

次の表に、Content API for Shopping と Merchant API のリクエストで使用される識別子を比較します。

識別子の説明	Content API for Shopping	Merchant API
アカウント ID	accountId	accounts/{account} の account
ユーザー識別子	AccountUser オブジェクト内の email_address	accounts/{account}/users/{email} の email

メソッド

次の表に、Content API for Shopping と Merchant API のメソッドを比較します。

Content API for Shopping	Merchant API	提供状況と注意事項
accounts.update	users.create	アカウントの新しいユーザーを作成します。
accounts.get	users.get	単一のユーザーを取得します。
accounts.get	users.list	アカウントのすべてのユーザーを一覧表示します。
accounts.update	users.update	ユーザーのアクセス権を更新します。
accounts.update	users.delete	アカウントからユーザーを削除します。

フィールドの詳細な変更点

フィールドの使用状況を次のように更新します。

Content API for Shopping	Merchant API	説明
users（繰り返し AccountUser）	users（繰り返し User）	User リソースは、独自のサービスを持つ最上位のリソースになりました。
AccountUser.email_address	CreateUserRequest.user_id と User.name の一部	ユーザーのメールアドレスがリソース名の一部になりました。作成時に user_id フィールドに指定します。
AccountUser.admin	access_rights: "ADMIN"	Merchant API では、ブール値の admin フィールドが access_rights 列挙型の ADMIN 値に置き換えられています。
AccountUser.order_manager、AccountUser.payments_manager、AccountUser.payments_analyst	access_rights: "STANDARD"	Merchant API では、これらのロールが STANDARD アクセス権に置き換えられています。
AccountUser.reporting_manager	access_rights: "PERFORMANCE_REPORTING"	reporting_manager ロールが PERFORMANCE_REPORTING アクセス権になりました。
AccountUser.read_only	access_rights: "READ_ONLY"	read_only ロールが READ_ONLY アクセス権になりました。
利用不可	User.name	ユーザーの完全なリソース名（accounts/{account}/users/{email} など）が含まれます。
利用不可	User.state	ユーザーの招待のステータス（PENDING または VERIFIED）を示します。