REST Resource: partners.targetingTypes.assignedTargetingOptions

משאב: AssignedTargetingOption

אפשרות טירגוט יחידה שהוקצתה, שמגדירה את הסטטוס של אפשרות טירגוט לישות עם הגדרות טירגוט.

ייצוג ב-JSON 
{
  "name": string,
  "assignedTargetingOptionId": string,
  "assignedTargetingOptionIdAlias": string,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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)
  },
  "contentThemeExclusionDetails": {
    object (ContentThemeAssignedTargetingOptionDetails)
  },
  "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)
  },
  "youtubeChannelPackDetails": {
    object (YoutubeChannelPackAssignedTargetingOptionDetails)
  }
  // End of mutually exclusive fields.
}
שדות
name

string

פלט בלבד. שם המשאב של אפשרות הטירגוט שהוקצתה.
assignedTargetingOptionId

string

פלט בלבד. המזהה הייחודי של אפשרות הטירגוט שהוקצתה. המזהה הוא ייחודי רק בתוך משאב מסוים וסוג טירגוט מסוים. יכול להיות שיהיה אפשר להשתמש בו שוב בהקשרים אחרים.
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)

פלט בלבד. סטטוס ההורשה של אפשרות הטירגוט שהוקצתה.
מידע מפורט על אפשרות הטירגוט שמוקצית. אפשר למלא רק שדה אחד בפרטים, והוא חייב להתאים ל-targeting_type. בהמשך מופיעה רשימה של שדות שמוציאים זה את זה. בכל תשובה יוגדר לכל היותר אחד מהשדות:
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)

פרטים על מיקום התוכן במודעות וידאו Outstream. השדה הזה יאוכלס כשהערך של targetingType יהיה TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.
deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

פרטים על סוג המכשיר. השדה הזה יאוכלס כשהערך של targetingType יהיה TARGETING_TYPE_DEVICE_TYPE.
audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

פרטים על טירגוט לפי קהל. השדה הזה יאוכלס כשהערך של targetingType יהיה TARGETING_TYPE_AUDIENCE_GROUP. אפשר לטרגט רק אפשרות אחת של קבוצת קהלים לכל משאב.
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)

פרטים על הספק וספק האינטרנט. השדה הזה יאוכלס כשהערך של 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.

אפשר לטרגט רק אפשרות אחת של נראות לכל משאב.
authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

פרטים על סטטוס המוכר המורשה. השדה הזה יאוכלס כשהערך של targetingType יהיה TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

אפשר לטרגט רק אפשרות אחת של סטטוס מוכר מורשה לכל משאב.

אם למשאב אין אפשרות סטטוס של מוכר מורשה, כל המוכרים המורשים שמסומנים כ-DIRECT או כ-RESELLER בקובץ ads.txt הם טירגוט ברירת המחדל.
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.

קטגוריות רגישות הן החרגות מטירגוט. אם הגדרתם החרגות של קטגוריות רגישות ברמת המפרסם, הן תמיד יחולו על הצגת המודעות (גם אם הן לא מוצגות בהגדרות המשאבים). הגדרות של מקורות מידע יכולות להחריג קטגוריות רגישות בנוסף להחרגות של מפרסמים, אבל לא יכולות לבטל אותן.
contentThemeExclusionDetails

object (ContentThemeAssignedTargetingOptionDetails)

פרטים על נושא התוכן. השדה הזה יאוכלס כשהערך של targetingType הוא TARGETING_TYPE_CONTENT_THEME_EXCLUSION.

נושאי תוכן הם החרגות של טירגוט. החרגות של נושאי תוכן ברמת המפרסם, אם הן מוגדרות, תמיד חלות על הצגת המודעות (גם אם הן לא מוצגות בהגדרות המשאבים). בהגדרות של נכס אפשר להחריג נושא תוכן בנוסף להחרגות של מפרסמים.
exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

פרטי ההחלפה. השדה הזה יאוכלס כשהערך של targetingType יהיה TARGETING_TYPE_EXCHANGE.
subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

פרטים על שער SUB. השדה הזה יאוכלס כשהערך של 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)

פרטים על מלאי שטחי פרסום שמופעלת בו מדידה פתוחה. השדה הזה יאוכלס כשהערך של 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.
youtubeChannelPackDetails

object (YoutubeChannelPackAssignedTargetingOptionDetails)

פרטים על חבילת ערוצים ב-YouTube. השדה הזה יאוכלס כשהערך של targetingType הוא TARGETING_TYPE_YOUTUBE_CHANNEL_PACK.
סוף השדות הבלעדיים.

Methods

create

 הקצאת אפשרות טירגוט לשותף.

delete

 מוחק אפשרות טירגוט שהוקצתה משותף.

get

 מקבלים אפשרות טירגוט אחת שמוקצית לשותף.

list

 רשימה של אפשרויות הטירגוט שהוקצו לשותף.