ユーザーのアクセス権では、ディスプレイ &ビデオ 360 サービス内で個人が行える操作を管理します。ユーザーは、認証時に使用された Google アカウントで識別されます。ユーザーのアクセス権の範囲は、ディスプレイ&ビデオ 360 の Partner
リソースまたは Advertiser
リソースにリンクされているユーザーロールによって決定されます。
このガイドでは、ユーザーを検索して作成する方法と、Display & Video 360 API を使用してユーザーにユーザー役割を割り当てる方法について説明します。
前提条件
Display & Video 360 API ユーザー サービスを使用するには、事前に次の手順を完了しておく必要があります。必要に応じて、チームの既存の管理者ユーザーに連絡して、必要なディスプレイ &ビデオ 360 のユーザー役割を有効にしてもらいます。
スタートガイドの手順に沿って、API プロジェクトを作成して承認します。
承認のサービス アカウント フローに従っていることを確認します。Display & Video 360 API の
users
サービスにアクセスできるのは、サービス アカウントのみです。認証プロセスでは、users
サービスに固有の OAuth スコープも使用する必要があります。サービス アカウントがディスプレイ &ビデオ 360 のユーザーであり、必要なリソースに必要なユーザーロールが付与されていることを確認します。ユーザーとその割り当てられたユーザーロールを変更できるのは、管理者ロールのみです。その他の標準ロールでは、ユーザー リソースに対する読み取りアクセス権のみが付与されます。
ユーザーロールについて
割り当てられるユーザー役割によって、ディスプレイ &ビデオ 360 のさまざまな広告配信リソースに対してユーザーが持つアクセスレベルが決まります。ユーザーロールについては、次の点に注意してください。
ユーザーロールは、
Advertiser
とPartner
の 2 種類のリソースタイプに対して指定できます。一部のユーザー役割は、特定のリソースタイプに対してのみ割り当てることができます。
パートナーにユーザー役割を割り当てると、そのパートナーのすべての広告主に対して、そのレベルのアクセス権が自動的に付与されます。
また、ユーザー ロールでは、アクセスできる他のユーザーや、ユーザーを作成したり、他のユーザーに割り当てられたロールを変更したりできるかどうかも制御します。ユーザーは、同じリソースへのアクセスを共有しているユーザーのみを表示できます。たとえば、パートナー リソースに対する標準権限を持っている場合、そのパートナーまたはそのパートナーに属する広告主にアクセスできるすべてのユーザーは、users.list
メソッドのレスポンスに含められます。