REST Resource: advertisers.insertionOrders.targetingTypes.assignedTargetingOptions

リソース: AssignedTargetingOption

1 つの割り当てられたターゲティング オプション。ターゲティング設定のあるエンティティのターゲティング オプションの状態を定義します。

JSON 表現 
{
  "name": string,
  "assignedTargetingOptionId": string,
  "assignedTargetingOptionIdAlias": string,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // Union field details can be only one of the following:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
フィールド
name

string

出力専用。この割り当てられたターゲティング オプションのリソース名。
assignedTargetingOptionId

string

出力専用。割り当てられたターゲティング オプションの一意の ID。ID は、特定のリソースとターゲティング タイプ内でのみ一意です。他のコンテキストで再利用できます。
assignedTargetingOptionIdAlias

string

出力専用。assignedTargetingOptionId のエイリアス。この値は、既存のターゲティングを取得または削除するときに assignedTargetingOptionId の代わりに使用できます。

このフィールドは、次のターゲティング タイプの割り当て済みのターゲティング オプションにのみ対応しています。

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

このフィールドは、次のターゲティング タイプの広告申込情報に割り当てられたターゲティング オプションでもサポートされています。

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

出力専用。この割り当てられたターゲティング オプションのタイプを指定します。
inheritance

enum (Inheritance)

出力専用。割り当てられたターゲティング オプションの継承ステータス。
共用体フィールド details。割り当てられているターゲティング オプションに関する詳細情報。details のフィールドは 1 つだけ入力できます。このフィールドは targeting_type に対応している必要があります。details は次のいずれか 1 つにする必要があります。
channelDetails

object (ChannelAssignedTargetingOptionDetails)

チャンネルの詳細。このフィールドは、targetingType が TARGETING_TYPE_CHANNEL の場合に入力されます。
appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

アプリのカテゴリの詳細。このフィールドは、targetingType が TARGETING_TYPE_APP_CATEGORY の場合に入力されます。
appDetails

object (AppAssignedTargetingOptionDetails)

アプリの詳細。このフィールドは、targetingType が TARGETING_TYPE_APP の場合に入力されます。
urlDetails

object (UrlAssignedTargetingOptionDetails)

URL の詳細。このフィールドは、targetingType が TARGETING_TYPE_URL の場合に入力されます。
dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

日時に関する詳細。このフィールドは、targetingType が TARGETING_TYPE_DAY_AND_TIME の場合に入力されます。
ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

年齢層の詳細。このフィールドは、targetingType が TARGETING_TYPE_AGE_RANGE の場合に入力されます。
regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

リージョン地域リストの詳細。このフィールドは、targetingType が TARGETING_TYPE_REGIONAL_LOCATION_LIST の場合に入力されます。
proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

近隣地域リストの詳細。このフィールドは、targetingType が TARGETING_TYPE_PROXIMITY_LOCATION_LIST の場合に入力されます。
genderDetails

object (GenderAssignedTargetingOptionDetails)

性別の詳細。このフィールドは、targetingType が TARGETING_TYPE_GENDER の場合に入力されます。
videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

動画プレーヤーのサイズの詳細。このフィールドは、targetingType が TARGETING_TYPE_VIDEO_PLAYER_SIZE の場合に入力されます。
userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

ユーザー リワードありのコンテンツの詳細。このフィールドは、targetingType が TARGETING_TYPE_USER_REWARDED_CONTENT の場合に入力されます。
parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

子供の有無の詳細。このフィールドは、targetingType が TARGETING_TYPE_PARENTAL_STATUS の場合に入力されます。
contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

コンテンツのインストリームの位置の詳細。このフィールドは、targetingType が TARGETING_TYPE_CONTENT_INSTREAM_POSITION の場合に入力されます。
contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

コンテンツのアウトストリーム プレースメントの詳細。このフィールドは、targetingType が TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION の場合に入力されます。
deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

デバイスタイプの詳細。このフィールドは、targetingType が TARGETING_TYPE_DEVICE_TYPE の場合に入力されます。
audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

オーディエンス ターゲティングの詳細。このフィールドは、targetingType が TARGETING_TYPE_AUDIENCE_GROUP の場合に入力されます。ターゲットに設定できるオーディエンス グループ オプションは、リソースごとに 1 つのみです。
browserDetails

object (BrowserAssignedTargetingOptionDetails)

ブラウザの詳細。このフィールドは、targetingType が TARGETING_TYPE_BROWSER の場合に入力されます。
householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

世帯収入の詳細。このフィールドは、targetingType が TARGETING_TYPE_HOUSEHOLD_INCOME の場合に入力されます。
onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

画面上の位置の詳細。このフィールドは、targetingType が TARGETING_TYPE_ON_SCREEN_POSITION の場合に入力されます。
carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

携帯通信会社と ISP の詳細。このフィールドは、targetingType が TARGETING_TYPE_CARRIER_AND_ISP の場合に入力されます。
keywordDetails

object (KeywordAssignedTargetingOptionDetails)

キーワードの詳細。このフィールドは、targetingType が TARGETING_TYPE_KEYWORD の場合に入力されます。

リソースに割り当てることができる直接除外キーワードは最大 5,000 個です。割り当てることができるポジティブ キーワードの数に上限はありません。
negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

キーワードの詳細。このフィールドは、targetingType が TARGETING_TYPE_NEGATIVE_KEYWORD_LIST の場合に入力されます。

リソースに割り当てることができる除外キーワード リストは最大 4 個です。
operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

オペレーティング システムの詳細。このフィールドは、targetingType が TARGETING_TYPE_OPERATING_SYSTEM の場合に入力されます。
deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

デバイスのメーカーとモデルの詳細。このフィールドは、targetingType が TARGETING_TYPE_DEVICE_MAKE_MODEL の場合に入力されます。
environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

環境の詳細。このフィールドは、targetingType が TARGETING_TYPE_ENVIRONMENT の場合に入力されます。
inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

広告枠ソースの詳細。このフィールドは、targetingType が TARGETING_TYPE_INVENTORY_SOURCE の場合に入力されます。
categoryDetails

object (CategoryAssignedTargetingOptionDetails)

カテゴリの詳細。このフィールドは、targetingType が TARGETING_TYPE_CATEGORY の場合に入力されます。

カテゴリをターゲットに設定すると、そのサブカテゴリもターゲットに設定されます。カテゴリがターゲティングから除外され、サブカテゴリがターゲットに含まれている場合は、除外が優先されます。
viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

視認性の詳細。このフィールドは、targetingType が TARGETING_TYPE_VIEWABILITY の場合に入力されます。

ターゲットに設定できる視認性オプションは、リソースごとに 1 つのみです。
authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

認定販売者のステータスの詳細。このフィールドは、targetingType が TARGETING_TYPE_AUTHORIZED_SELLER_STATUS の場合に入力されます。

リソースごとにターゲットにできる認定販売者ステータス オプションは 1 つのみです。

リソースに認定販売者ステータス オプションがない場合は、ads.txt ファイルで「DIRECT」または「RESELLER」と指定されているすべての認定販売者がデフォルトでターゲットに設定されます。
languageDetails

object (LanguageAssignedTargetingOptionDetails)

言語の詳細。このフィールドは、targetingType が TARGETING_TYPE_LANGUAGE の場合に入力されます。
geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

地域の詳細。このフィールドは、targetingType が TARGETING_TYPE_GEO_REGION の場合に入力されます。
inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

広告枠ソースグループの詳細。このフィールドは、targetingType が TARGETING_TYPE_INVENTORY_SOURCE_GROUP の場合に入力されます。
digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

デジタル コンテンツ ラベルの詳細。このフィールドは、targetingType が TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION の場合に入力されます。

デジタル コンテンツ ラベルはターゲティングの除外です。広告主レベルのデジタル コンテンツ ラベルの除外設定がされている場合、その設定は（リソース設定には表示されなくても）配信時に常に適用されます。リソース設定では、広告主の除外設定に加えてコンテンツ ラベルを除外できますが、オーバーライドすることはできません。すべてのデジタル コンテンツ ラベルが除外されている場合、広告申込情報は配信されません。
sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

デリケートなカテゴリの詳細。このフィールドは、targetingType が TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION の場合に入力されます。

デリケートなカテゴリはターゲティングの除外です。広告主レベルのデリケートなカテゴリの除外を設定すると、リソース設定に表示されない場合でも、常に配信時に適用されます。リソース設定では、広告主の除外に加えて、デリケートなカテゴリを除外することはできますが、オーバーライドすることはできません。
exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

交換の詳細。このフィールドは、targetingType が TARGETING_TYPE_EXCHANGE の場合に入力されます。
subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

サブエクスチェンジの詳細。このフィールドは、targetingType が TARGETING_TYPE_SUB_EXCHANGE の場合に入力されます。
thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

サードパーティによる検証の詳細。このフィールドは、targetingType が TARGETING_TYPE_THIRD_PARTY_VERIFIER の場合に入力されます。
poiDetails

object (PoiAssignedTargetingOptionDetails)

スポットの詳細。このフィールドは、targetingType が TARGETING_TYPE_POI の場合に入力されます。
businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

ビジネス チェーンの詳細。このフィールドは、targetingType が TARGETING_TYPE_BUSINESS_CHAIN の場合に入力されます。
contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

コンテンツの長さの詳細。このフィールドは、targetingType が TARGETING_TYPE_CONTENT_DURATION の場合に入力されます。
contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

コンテンツの長さの詳細。このフィールドは、TargetingType が TARGETING_TYPE_CONTENT_STREAM_TYPE の場合に入力されます。
nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

ネイティブ コンテンツの位置の詳細。このフィールドは、targetingType が TARGETING_TYPE_NATIVE_CONTENT_POSITION の場合に入力されます。
omidDetails

object (OmidAssignedTargetingOptionDetails)

Open Measurement が有効な広告枠の詳細。このフィールドは、targetingType が TARGETING_TYPE_OMID の場合に入力されます。
audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

オーディオ コンテンツ タイプの詳細。このフィールドは、targetingType が TARGETING_TYPE_AUDIO_CONTENT_TYPE の場合に入力されます。
contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

コンテンツ ジャンルの詳細。このフィールドは、targetingType が TARGETING_TYPE_CONTENT_GENRE の場合に入力されます。
youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

YouTube 動画の詳細。このフィールドは、targetingType が TARGETING_TYPE_YOUTUBE_VIDEO の場合に入力されます。
youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

YouTube チャンネルの詳細。このフィールドは、targetingType が TARGETING_TYPE_YOUTUBE_CHANNEL の場合に入力されます。
sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

セッションの位置の詳細。このフィールドは、targetingType が TARGETING_TYPE_SESSION_POSITION の場合に入力されます。

メソッド

create

 ターゲティング オプションを広告掲載オーダーに割り当てます。

delete

 割り当てられたターゲティング オプションを広告掲載オーダーから削除します。

get

 広告掲載オーダーに割り当てられているターゲティング オプションを 1 つ取得します。

list

 広告掲載オーダーに割り当てられているターゲティング オプションを一覧表示します。