REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

string (int64 format)

必須。チャンネルの ID。パートナー所有チャンネルまたは広告主所有チャンネルリソースのチャンネル ID フィールドを参照する必要があります。

boolean

このオプションが除外設定の対象になっているかどうかを示します。広告主レベルで割り当てられたターゲティング オプションの場合、このフィールドは true にする必要があります。

string

出力専用。アプリ カテゴリの表示名。

string

必須。targetingType が TARGETING_TYPE_APP_CATEGORY の場合の targetingOptionId フィールド。

boolean

このオプションが除外設定の対象になっているかどうかを示します。

string

必須。アプリの ID。

Android の Google Play ストア アプリは、バンドル ID（例: com.google.android.gm）を使用します。Apple の App Store アプリ ID は 9 桁の文字列（例: 422689480）を使用します。

string

出力専用。アプリの表示名。

boolean

このオプションが除外設定の対象になっているかどうかを示します。

enum (AppPlatform)

対象アプリのプラットフォームを示します。このフィールドが指定されていない場合、アプリ プラットフォームはモバイル（つまり、Android または iOS）を指定します。アプリ ID から適切なモバイル プラットフォームが導出されます。

string

必須。URL（例: example.com）。

ディスプレイ＆ビデオ 360 では、2 レベルのサブディレクトリ（例: www.example.com/one-subdirectory-level/second-level）と、5 レベルのサブドメイン（例: five.four.three.two.one.example.com）のターゲティングがサポートされています。

boolean

このオプションが除外設定の対象になっているかどうかを示します。

enum (DayOfWeek)

必須。この曜日と時間帯のターゲティング設定の曜日。

integer

必須。曜日と時間のターゲティングの開始時間。0（1 日の始まり）から 23（1 日の終わりの 1 時間前）までの範囲で指定する必要があります。

integer

必須。曜日と時間のターゲティングの終了時間。1（1 日の開始から 1 時間後）～ 24（1 日の終了）の範囲で指定する必要があります。

enum (TimeZoneResolution)

必須。この曜日と時間ターゲティング設定に使用するタイムゾーンを決定するために使用されるメカニズム。

enum (AgeRange)

必須。オーディエンスの年齢層。オーディエンスの連続した年齢範囲のターゲティングのみがサポートされています。したがって、このフィールドで表される年齢層は、1）単独でターゲティングされるか、2）より広い連続した年齢層の一部となります。連続した年齢層のターゲティングのリーチは、年齢が不明なユーザーをターゲットにすることで拡大できます。

string (int64 format)

必須。リージョン地域リストの ID。タイプが TARGETING_LOCATION_TYPE_REGIONAL の LocationList リソースの locationListId フィールドを参照する必要があります。

boolean

このオプションが除外設定の対象になっているかどうかを示します。

string (int64 format)

必須。近接地域のリストの ID。タイプが TARGETING_LOCATION_TYPE_PROXIMITY の LocationList リソースの locationListId フィールドを参照する必要があります。

number

必須。proximityRadiusUnit で設定された距離の単位で表される半径。これは、選択した場所を中心とするターゲット エリアのサイズを表します。半径は 1 ～ 500 マイルまたは 800 km の範囲で指定してください。

enum (ProximityRadiusUnit)

必須。半径距離の単位。

enum (Gender)

必須。オーディエンスの性別。

enum (VideoPlayerSize)

必須。動画プレーヤーのサイズ。

string

必須。targetingType が TARGETING_TYPE_USER_REWARDED_CONTENT の場合の targetingOptionId フィールド。

enum (UserRewardedContent)

出力専用。動画広告のユーザー リワードありのコンテンツのステータス。

enum (ParentalStatus)

必須。オーディエンスの子供の有無。

enum (ContentInstreamPosition)

必須。動画広告または音声広告のコンテンツ インストリームの位置。

enum (AdType)

出力専用。ターゲットとする広告タイプ。広告掲載オーダーのターゲティングにのみ適用されます。指定された広告タイプをサポートする新しい広告申込情報には、デフォルトでこのターゲティング オプションが継承されます。次の値があります。

• AD_TYPE_VIDEO の場合、lineItemType が LINE_ITEM_TYPE_VIDEO_DEFAULT のときに新しい広告申込情報に設定が継承されます。
• AD_TYPE_AUDIO の場合、lineItemType が LINE_ITEM_TYPE_AUDIO_DEFAULT のときに新しい広告申込情報に設定が継承されます。

enum (ContentOutstreamPosition)

必須。コンテンツ アウトストリームの位置。

enum (AdType)

出力専用。ターゲットとする広告タイプ。広告掲載オーダーのターゲティングにのみ適用されます。指定された広告タイプをサポートする新しい広告申込情報には、デフォルトでこのターゲティング オプションが継承されます。次の値があります。

• AD_TYPE_DISPLAY の場合、lineItemType が LINE_ITEM_TYPE_DISPLAY_DEFAULT のときに新しい広告申込情報に設定が継承されます。
• AD_TYPE_VIDEO の場合、lineItemType が LINE_ITEM_TYPE_VIDEO_DEFAULT のときに新しい広告申込情報に設定が継承されます。

enum (DeviceType)

必須。デバイスタイプの表示名。

number

出力専用。入札単価乗数を使用すると、デバイスの種類に応じて、広告を表示する頻度を調整できます。元の入札単価に単価調整比が適用されます。このフィールドが 0 の場合、元の入札単価に 0 を掛けるのではなく、このフィールドが該当しないことを示します。

たとえば、単価調整比なしの入札単価が $10.0 で、タブレットの単価調整比が 1.5 の場合、タブレットの入札単価は $15.0 になります。

YouTube とパートナーの広告申込情報にのみ適用されます。

object (GoogleAudienceGroup)

省略可。含まれる Google オーディエンス グループの Google オーディエンス ID。Google オーディエンス ID のみを含みます。

object (CustomListGroup)

省略可。含まれるカスタムリスト グループのカスタムリスト ID。カスタムリスト ID のみを含みます。

object (CombinedAudienceGroup)

省略可。追加された組み合わせオーディエンス グループの組み合わせオーディエンス ID。組み合わせオーディエンス ID のみを含みます。

object (GoogleAudienceGroup)

省略可。除外された Google オーディエンス グループの Google オーディエンス ID。ターゲット除外に使用されます。このグループと他の除外オーディエンス グループの和集合の補集合は、ポジティブなオーディエンス ターゲティングとの積集合として使用されます。アフィニティ、購買意向の強いオーディエンス、インストール済みアプリのタイプの Google オーディエンスのみが含まれます。すべての項目は互いに論理的に「OR」です。

object (FirstPartyAndPartnerAudienceGroup)

省略可。含まれるファーストパーティ オーディエンス グループとパートナー オーディエンス グループのファーストパーティ オーディエンス ID とパートナー オーディエンス ID、および最新の更新日。各ファーストパーティ オーディエンス グループとパートナー オーディエンス グループには、ファーストパーティ オーディエンス ID とパートナー オーディエンス ID のみが含まれます。各ファーストパーティ オーディエンス グループとパートナー オーディエンス グループの関係は INTERSECTION であり、結果は他のオーディエンス グループと UNION されます。同じ設定のグループが繰り返されている場合は無視されます。

object (FirstPartyAndPartnerAudienceGroup)

省略可。除外されたファーストパーティ オーディエンス グループとパートナー オーディエンス グループのファーストパーティ オーディエンス ID とパートナー オーディエンス ID、および最新の更新日。ターゲット除外に使用されます。このグループと他の除外オーディエンス グループの和集合の補集合は、ポジティブなオーディエンス ターゲティングとの積集合として使用されます。すべての項目は互いに論理的に「OR」です。

object (GoogleAudienceTargetingSetting)

必須。Google オーディエンス グループ内のすべての Google オーディエンス ターゲティング設定。同じ ID の設定が繰り返されている場合は無視されます。

string (int64 format)

必須。Google オーディエンス ターゲティング設定の Google オーディエンス ID。この ID は googleAudienceId です。

object (CustomListTargetingSetting)

必須。カスタムリスト グループ内のすべてのカスタムリスト ターゲティング設定。同じ ID の設定が繰り返されている場合は無視されます。

string (int64 format)

必須。カスタムリスト ターゲティング設定のカスタム ID。この ID は customListId です。

object (CombinedAudienceTargetingSetting)

必須。組み合わせオーディエンス グループ内のすべての組み合わせオーディエンスのターゲティング設定。同じ ID の設定が繰り返されている場合は無視されます。組み合わせオーディエンスの設定数は 5 件以下にする必要があります。それ以外の場合はエラーがスローされます。

string (int64 format)

必須。組み合わせオーディエンス ターゲティング設定の組み合わせオーディエンス ID。この ID は combinedAudienceId です。

object (FirstPartyAndPartnerAudienceTargetingSetting)

必須。ファーストパーティ オーディエンス グループとパートナー オーディエンス グループのすべてのファーストパーティ オーディエンスとパートナー オーディエンスのターゲティング設定。同じ ID の設定を繰り返すことはできません。

string (int64 format)

必須。ファーストパーティ オーディエンスとパートナー オーディエンスのターゲティング設定のファーストパーティ オーディエンスとパートナー オーディエンスの ID。この ID は firstPartyAndPartnerAudienceId です。

enum (Recency)

必須。ファーストパーティ オーディエンスとパートナー オーディエンスのターゲティング設定の最新性。自社オーディエンスにのみ適用され、それ以外の場合は無視されます。詳しくは、https://support.google.com/displayvideo/answer/2949947#recency をご覧ください。指定しない場合、フリークエンシーの上限は使用されません。

string

出力専用。ブラウザの表示名。

string

必須。TARGETING_TYPE_BROWSER 型の TargetingOption の targetingOptionId。

boolean

このオプションが除外設定の対象になっているかどうかを示します。同じリソースに割り当てられたブラウザ ターゲティング オプションでは、このフィールドの値がすべて同じである必要があります。

enum (HouseholdIncome)

必須。オーディエンスの世帯収入。

string

必須。targetingType が TARGETING_TYPE_ON_SCREEN_POSITION の場合の targetingOptionId フィールド。

enum (OnScreenPosition)

出力専用。画面上の位置。

enum (AdType)

出力専用。ターゲットとする広告タイプ。広告掲載オーダーのターゲティングにのみ適用されます。指定された広告タイプをサポートする新しい広告申込情報には、デフォルトでこのターゲティング オプションが継承されます。次の値があります。

• AD_TYPE_DISPLAY の場合、lineItemType が LINE_ITEM_TYPE_DISPLAY_DEFAULT のときに新しい広告申込情報に設定が継承されます。
• AD_TYPE_VIDEO の場合、lineItemType が LINE_ITEM_TYPE_VIDEO_DEFAULT のときに新しい広告申込情報に設定が継承されます。

string

出力専用。携帯通信会社または ISP の表示名。

string

必須。TARGETING_TYPE_CARRIER_AND_ISP 型の TargetingOption の targetingOptionId。

boolean

このオプションが除外設定の対象になっているかどうかを示します。同じリソースに割り当てられているすべての携帯通信会社と ISP のターゲティング オプションで、このフィールドの値が同じである必要があります。

string

必須。キーワード（例: car insurance）。

ポジティブ キーワードに不適切な単語を含めることはできません。UTF-8 でエンコードし、最大サイズを 255 バイトにする必要があります。最大文字数は 80 文字です。単語の最大数は 10 です。

boolean

このオプションが除外設定の対象になっているかどうかを示します。

string (int64 format)

必須。除外キーワード リストの ID。NegativeKeywordList リソースの negativeKeywordListId フィールドを参照する必要があります。

string

出力専用。オペレーティング システムの表示名。

string

必須。targetingType が TARGETING_TYPE_OPERATING_SYSTEM の場合、targetingOptionId フィールドに入力されるターゲティング オプション ID。

boolean

このオプションが除外設定の対象になっているかどうかを示します。

string

出力専用。デバイスのメーカーとモデルの表示名。

string

必須。targetingType が TARGETING_TYPE_DEVICE_MAKE_MODEL の場合の targetingOptionId フィールド。

boolean

このオプションが除外設定の対象になっているかどうかを示します。

enum (Environment)

必須。サービング環境。

string (int64 format)

必須。広告枠ソースの ID。InventorySource リソースの inventorySourceId フィールドを参照する必要があります。

string

出力専用。カテゴリの表示名。

string

必須。targetingType が TARGETING_TYPE_CATEGORY の場合の targetingOptionId フィールド。

boolean

このオプションが除外設定の対象になっているかどうかを示します。

enum (Viewability)

必須。予測される視認性の割合。

enum (AuthorizedSellerStatus)

出力専用。ターゲットとする認定販売者のステータス。

string

必須。TARGETING_TYPE_AUTHORIZED_SELLER_STATUS 型の TargetingOption の targetingOptionId。

string

出力専用。言語の表示名（例: 「フランス語」）。

string

必須。TARGETING_TYPE_LANGUAGE 型の TargetingOption の targetingOptionId。

boolean

このオプションが除外設定の対象になっているかどうかを示します。同じリソースに割り当てられているすべての言語ターゲティング オプションで、このフィールドの値が同じである必要があります。

string

出力専用。地域（「オンタリオ州、カナダ」）。

string

必須。TARGETING_TYPE_GEO_REGION 型の TargetingOption の targetingOptionId。

enum (GeoRegionType)

出力専用。地域ターゲティングのタイプ。

boolean

このオプションが除外設定の対象になっているかどうかを示します。

string (int64 format)

必須。広告枠ソース グループの ID。InventorySourceGroup リソースの inventorySourceGroupId フィールドを参照する必要があります。

enum (ContentRatingTier)

必須。除外するデジタル コンテンツ ラベルのレーティング ティアの表示名。

enum (SensitiveCategory)

必須。除外対象として分類されたディスプレイ＆ビデオ 360 のデリケートなカテゴリのコンテンツの列挙型。

string

必須。除外するコンテンツ テーマの ID。

enum (ContentTheme)

出力専用。ディスプレイ＆ビデオ 360 のコンテンツ テーマ分類子の列挙型。

enum (ContentTheme)

必須。除外対象として分類されたディスプレイ＆ビデオ 360 のコンテンツ テーマの列挙型。

enum (Exchange)

必須。エクスチェンジの列挙型値。

string

必須。TARGETING_TYPE_SUB_EXCHANGE 型の TargetingOption の targetingOptionId。

object (Adloox)

第三者のブランド検証機関 - Scope3（旧 Adloox）。

object (DoubleVerify)

第三者ブランド検証機関 - DoubleVerify。

object (IntegralAdScience)

第三者ブランド検証機関 - Integral Ad Science。

enum (AdlooxCategory)

除外する Scope3 カテゴリ。

enum (FraudIvtMfaCategory)

省略可。除外する Scope3 の不正行為 IVT MFA カテゴリ。

enum (GarmRiskExclusion)

省略可。除外するアダルト コンテンツ、露骨な性的コンテンツの GARM リスク範囲。

enum (GarmRiskExclusion)

省略可。犯罪、悪事に関するコンテンツの GARM リスク範囲（除外対象）。

enum (GarmRiskExclusion)

省略可。除外する武器、弾薬に関するコンテンツの GARM リスク範囲。

enum (GarmRiskExclusion)

省略可。死亡、負傷、軍事紛争に関するコンテンツ GARM の除外対象となるリスク範囲。

enum (GarmRiskExclusion)

省略可。議論が交わされているデリケートな社会問題に関するコンテンツの GARM リスク範囲を除外します。

enum (GarmRiskExclusion)

省略可。除外する違法薬物/アルコールに関するコンテンツの GARM リスク範囲。

enum (GarmRiskExclusion)

省略可。インターネット上の著作権侵害のコンテンツの GARM リスク範囲を除外します。

enum (GarmRiskExclusion)

省略可。ヘイトスピーチ、攻撃行為に関するコンテンツ GARM のリスク範囲を除外します。

enum (GarmRiskExclusion)

省略可。わいせつ / 冒とく的な表現のコンテンツの GARM リスク範囲を除外します。

enum (GarmRiskExclusion)

省略可。除外するスパムまたは有害なコンテンツの GARM リスク範囲。

enum (GarmRiskExclusion)

省略可。除外するテロに関するコンテンツの GARM リスク範囲。

enum (GarmRiskExclusion)

省略可。除外する誤った情報のコンテンツの GARM リスク範囲。

enum (DisplayIabViewability)

省略可。ディスプレイ広告の IAB 視認性しきい値。

enum (VideoIabViewability)

省略可。動画広告の IAB 視認可能率のしきい値。

object (BrandSafetyCategories)

DV ブランド保護設定。

enum (AgeRating)

アプリの対象年齢が次に該当する場合、入札を行わない。

object (AppStarRating)

スター評価が次のアプリへの入札を回避します。

object (DisplayViewability)

ディスプレイの視認性設定（ディスプレイ広告申込情報にのみ適用されます）。

object (VideoViewability)

動画の視認性設定（動画広告申込情報にのみ適用されます）。

object (FraudInvalidTraffic)

過去に不正行為や無効なトラフィックが発生しているサイトやアプリを回避します。

string (int64 format)

DoubleVerify から提供されたカスタム セグメント ID。ID は「51」で始まり、8 桁の数字で構成されている必要があります。カスタム セグメント ID は、次のフィールドのいずれかと一緒に指定することはできません。

• brandSafetyCategories
• avoidedAgeRatings
• appStarRating
• fraudInvalidTraffic

boolean

不明または評価不可。

enum (HighSeverityCategory)

ブランド保護の高重大度回避カテゴリ。

enum (MediumSeverityCategory)

ブランド保護の中程度の重大度の回避カテゴリ。

enum (StarRating)

スター評価が次のアプリへの入札を回避します。

boolean

スター評価が不十分なアプリへの入札を回避します。

enum (IAB)

IAB 視認可能率が最も高くなるようにウェブとアプリの広告枠をターゲティングします。

enum (ViewableDuring)

100% 視認可能な時間が最も長くなるようにウェブとアプリの広告枠をターゲティングします。

enum (VideoIAB)

IAB 視認可能率が最も高くなるようにウェブの広告枠をターゲティングします。

enum (VideoViewableRate)

完全視認可能率が最も高くなるようにウェブの広告枠をターゲティングする。

enum (PlayerImpressionRate)

400x300 以上のプレーヤー サイズでインプレッションが最も多くなるように広告枠をターゲティングします。

enum (FraudOption)

過去に不正行為や無効なトラフィックが発生しているサイトやアプリを回避します。

boolean

不正行為や無効なトラフィックの発生率に関する統計データが不明。

enum (TRAQScore)

実際の広告品質（ディスプレイ広告申込情報にのみ適用されます）。

boolean

ブランド保護 - 評価不能。

enum (Adult)

ブランド保護 - アダルト コンテンツ。

enum (Alcohol)

ブランド保護 - アルコール。

enum (IllegalDownloads)

ブランド保護 - 違法なダウンロード。

enum (Drugs)

ブランド保護 - 薬物。

enum (HateSpeech)

ブランド保護 - ヘイトスピーチ。

enum (OffensiveLanguage)

ブランド保護 - 攻撃的な表現。

enum (Violence)

ブランド保護 - 暴力。

enum (Gambling)

ブランド保護 - ギャンブル。

enum (AdFraudPrevention)

広告の不正行為の設定。

enum (DisplayViewability)

[ディスプレイの視認性] セクション（ディスプレイ広告申込情報にのみ適用されます）。

enum (VideoViewability)

動画の視認性セクション（動画広告申込情報にのみ適用されます）。

string (int64 format)

Integral Ad Science から提供されたカスタム セグメント ID。ID は 1000001～1999999 または 3000001～3999999 の範囲で指定する必要があります（両端を含む）。

string (int64 format)

省略可。Integral Ad Science から提供された品質同期カスタム セグメント ID。ID は 3000000 以上 4999999 以下の範囲で指定してください。

string

出力専用。POI の表示名（例: 「タイムズ スクエア」、「スペース ニードル」）。利用可能な場合は、完全な住所も表示されます。

string

必須。TARGETING_TYPE_POI 型の TargetingOption の targetingOptionId。

使用できるスポット ターゲティング オプション ID は、targetingTypes.targetingOptions.search を使用して取得できます。

住所やスポット名から削除された特定の緯度/経度座標をターゲットに設定する場合は、目的の座標値を小数点以下 6 桁に丸め、小数点を削除し、セミコロンで区切られた文字列値を連結することで、必要なターゲティング オプション ID を生成できます。たとえば、ターゲット設定オプション ID「40741469;-74003387」を使用すると、緯度と経度のペア「40.7414691, -74.003387」をターゲットに設定できます。作成時に、緯度/経度の座標のみが指定されている場合、このフィールド値は更新され、セミコロンと英数字のハッシュ値が追加されます。

number

出力専用。POI の緯度（小数点第 6 位まで）。

number

出力専用。POI の経度（小数点第 6 位まで）。

number

必須。ターゲットとなる POI 周辺のエリアの半径。半径の単位は proximityRadiusUnit で指定します。単位が DISTANCE_UNIT_KILOMETERS の場合は 1 ～ 800、単位が DISTANCE_UNIT_MILES の場合は 1 ～ 500 にする必要があります。

enum (DistanceUnit)

必須。ターゲティング半径の測定単位。

string

出力専用。ビジネス チェーンの表示名（例: 「KFC」、「Chase Bank」）。

string

必須。TARGETING_TYPE_BUSINESS_CHAIN 型の TargetingOption の targetingOptionId。

受け入れられたビジネス チェーン ターゲティング オプション ID は、SearchTargetingOptions を使用して取得できます。

number

必須。ビジネス チェーンの周囲の対象範囲の半径。半径の単位は proximityRadiusUnit で指定します。単位が DISTANCE_UNIT_KILOMETERS の場合は 1 ～ 800、単位が DISTANCE_UNIT_MILES の場合は 1 ～ 500 にする必要があります。どちらの場合も、最小増分は 0.1 です。入力が細かすぎる場合、最も近い許容値に丸められます（例: 15.57 は 15.6 になります）。

enum (DistanceUnit)

必須。ターゲティング半径の測定単位。

string

必須。targetingType が TARGETING_TYPE_CONTENT_DURATION の場合の targetingOptionId フィールド。

enum (ContentDuration)

出力専用。コンテンツの長さ。

string

必須。targetingType が TARGETING_TYPE_CONTENT_STREAM_TYPE の場合の targetingOptionId フィールド。

enum (ContentStreamType)

出力専用。コンテンツ ストリームのタイプ。

enum (NativeContentPosition)

必須。コンテンツの位置。

enum (Omid)

必須。Open Measurement が有効な広告枠のタイプ。

enum (AudioContentType)

必須。オーディオ コンテンツ タイプ。

string

必須。targetingType が TARGETING_TYPE_CONTENT_GENRE の場合の targetingOptionId フィールド。

string

出力専用。コンテンツのジャンルの表示名。

boolean

このオプションが除外設定の対象になっているかどうかを示します。

string

YouTube の動画再生ページに表示される YouTube 動画 ID。

boolean

このオプションが除外設定の対象になっているかどうかを示します。

string

YouTube アップロード チャンネル ID または YouTube チャンネルのチャンネル コード。

boolean

このオプションが除外設定の対象になっているかどうかを示します。

enum (SessionPosition)

セッション内で広告が表示される位置。