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 アセット グループはポリシー審査を完了していません。