管理者は、Google 広告アカウントのユーザーのアクセスレベルとロールを管理できます。Google 広告 API を使用して、ユーザーロールの取得と更新、ユーザーの招待、アカウントへのユーザー アクセスの終了を行うことができます。 詳しくは、アカウントのアクセスレベルについての記事をご覧ください。
ユーザー アクセスを管理するには、呼び出し元のユーザーまたはサービス アカウントに、対象アカウントに対する ADMIN アクセス権が必要です。
ユーザーを招待する
新しいユーザーを招待してアカウントにアクセスさせるには、
CustomerUserAccessInvitationService を使用して招待状を作成し、送信します（
ユーザー アクセス招待状を管理するをご覧ください）。ユーザーが招待を承諾すると、[CustomerUserAccess] に確認済みのユーザーとして表示されます。
ユーザーロールを取得する
アカウントにアクセスできるユーザーのリストを取得するには、
Google 広告クエリ言語 ステートメントを作成して、顧客 ID に関連付けられているすべての
CustomerUserAccess エンティティをクエリします。一般的なクエリは次のとおりです。
SELECT
customer_user_access.user_id,
customer_user_access.email_address,
customer_user_access.access_role,
customer_user_access.access_creation_date_time,
customer_user_access.inviter_user_email_address
FROM customer_user_access
ユーザーロールを変更する
既存のユーザーロールを更新するには、UPDATE オペレーションを使用して CustomerUserAccessService.MutateCustomerUserAccess を呼び出します。ユーザーロールを変更する場合は、次の情報を提供する必要があります。
- 変更する
CustomerUserAccessエンティティのリソース名（形式:customers/{customer_id}/customerUserAccesses/{user_id}）。 access_roleの新しいユーザーロール。access_roleを指定するupdate_mask（FieldMask）。
ユーザーを削除する
ユーザーのアカウントへのアクセスを終了するには、リソース名（customers/{customer_id}/customerUserAccesses/{user_id}）を指定して REMOVE オペレーションで CustomerUserAccessService.MutateCustomerUserAccess を呼び出します。
アクセス変更に対する複数の関係者による承認
MutateCustomerUserAccess を呼び出したときに複数の関係者による承認リクエストがトリガーされた場合:
MutateCustomerUserAccessResultオブジェクト （MutateCustomerUserAccessResponseのresultフィールドに含まれる）のmulti_party_auth_reviewフィールドに、承認が必要な保留中の審査のリソース名が入力されます。MutateCustomerUserAccessResultのresource_nameフィールドには何も入力されません。- 保留中の審査リクエストは、2 人目の
管理者が
MultiPartyAuthReviewService.ResolveMultiPartyAuthReviewメソッドを使用して承認または拒否できます。詳しくは、複数の関係者による承認 に関するガイドをご覧ください。