AssetGroup

アセット グループAssetGroupAsset は、アセットをアセット グループにリンクするために使用されます。AssetGroupSignal は、シグナルをアセット グループに関連付けるために使用されます。

JSON 表現
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "primaryStatus": enum (AssetGroupPrimaryStatus),
  "primaryStatusReasons": [
    enum (AssetGroupPrimaryStatusReason)
  ],
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
フィールド
resourceName

string

変更不可。アセット グループのリソース名。アセット グループのリソース名の形式は次のとおりです。

customers/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

出力のみ。アセット グループの ID

campaign

string

変更不可。このアセット グループが関連付けられているキャンペーン。アセット グループにリンクされているアセット。

name

string

必須。アセット グループの名前。必須。長さは 1 ~ 128 文字以内にする必要があります。キャンペーン内で一意である必要があります。

finalUrls[]

string

すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。P-MAX では、オプトアウトしない限り、URL はデフォルトで拡張の対象となります。

finalMobileUrls[]

string

すべてのクロスドメイン リダイレクト後のモバイルの最終ページ URL のリスト。P-MAX では、オプトアウトしない限り、URL はデフォルトで拡張の対象となります。

status

enum (AssetGroupStatus)

アセット グループのステータス。

primaryStatus

enum (AssetGroupPrimaryStatus)

出力のみ。アセット グループのメインのステータス。アセット グループが配信されない理由や、アセット グループが最適に配信されない原因を分析できます。

primaryStatusReasons[]

enum (AssetGroupPrimaryStatusReason)

出力のみ。アセット グループが配信されない、または最適に配信されていない理由を把握できます。アセット グループが問題なく配信されている場合は空になります。

path1

string

広告に表示される URL に表示されるテキストの最初の部分です。

path2

string

広告に表示される URL に付加されて表示されるテキストの 2 番目の部分。このフィールドは、path1 が設定されている場合にのみ設定できます。

adStrength

enum (AdStrength)

出力のみ。このアセット グループの全体的な広告の有効性。

AssetGroupStatus

アセット グループのステータスです。

列挙型
UNSPECIFIED ステータスが指定されていません。
UNKNOWN このバージョンでは受信した値が不明です。
ENABLED アセット グループは有効になっています。
PAUSED アセット グループは一時停止されています。
REMOVED アセット グループが削除されました。

AssetGroupPrimaryStatus

アセット グループのプライマリ ステータスを記述する列挙型。アセット グループが配信されない理由や、アセット グループが最適に配信されない原因を分析できます。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ELIGIBLE アセット グループは配信可能です。
PAUSED アセット グループは一時停止されています。
REMOVED アセット グループが削除されました。
NOT_ELIGIBLE このアセット グループは配信できません。
LIMITED アセット グループの配信が制限されています。
PENDING アセット グループは承認待ちのため、今後配信される可能性があります。

AssetGroupPrimaryStatusReason

アセット グループのメイン ステータスとして考えられる理由を説明する列挙型です。アセット グループが配信されない、または最適に配信されていない理由を把握できます。アセット グループが問題なく配信されている場合は空になります。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ASSET_GROUP_PAUSED ユーザーが指定したアセット グループのステータスが一時停止されています。
ASSET_GROUP_REMOVED ユーザー指定のアセット グループのステータスが削除されます。
CAMPAIGN_REMOVED ユーザー指定のキャンペーン ステータスが削除されます。
CAMPAIGN_PAUSED ユーザーが指定したキャンペーンのステータスは一時停止されています。
CAMPAIGN_PENDING ユーザーが指定した、このキャンペーンの開始日時が将来の日時です。
CAMPAIGN_ENDED このキャンペーンの終了日時を過ぎています。
ASSET_GROUP_LIMITED アセット グループは承認されていますが、ポリシーにより、配信できるスペースが制限されています。
ASSET_GROUP_DISAPPROVED アセット グループに不承認のマークを付けました。
ASSET_GROUP_UNDER_REVIEW アセット グループのポリシー審査が完了していません。