REST Resource: advertisers.lineItems.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)

تفاصيل موضع الإعلان خارج البث ستتم تعبئة هذا الحقل عندما تكون قيمة 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.

يمكن تعيين 5000 كلمة رئيسية سلبية مباشرة كحدّ أقصى لأحد المراجع. ما مِن حدّ أقصى لعدد الكلمات الرئيسية الإيجابية التي يمكن تعيينها.
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)

تفاصيل التبادل الفرعي ستتم تعبئة هذا الحقل عندما تكون قيمة 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.
youtubeChannelPackDetails

object (YoutubeChannelPackAssignedTargetingOptionDetails)

تفاصيل حزمة قنوات YouTube ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_YOUTUBE_CHANNEL_PACK.
نهاية الحقول التي يستبعد كلّ منها الآخر

الطُرق

create

 تُستخدَم لتعيين خيار استهداف لبند إعلاني.

delete

 تحذف هذه الطريقة خيار استهداف تمّ تعيينه من بند إعلاني.

get

 تعرض هذه الطريقة خيار استهداف واحدًا تمّ تعيينه لبند إعلاني.

list

 تعرض هذه السمة خيارات الاستهداف المحدّدة لأحد البنود الإعلانية.