REST Resource: partners.targetingTypes.assignedTargetingOptions

المورد: assignTargetOption

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

تمثيل 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

النتائج فقط. المعرّف الفريد لخيار الاستهداف المحدّد يكون رقم التعريف فريدًا فقط ضمن نوع استهداف ومورد معيّن. وقد يُعاد استخدامه في سياقات أخرى.
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. معلومات تفصيلية عن خيار الاستهداف الذي يتمّ تعيينه. يجب ملء حقل واحد فقط بالتفاصيل، ويجب أن يتوافق مع السمة targeting_type. يمكن أن تكون السمة details واحدًا مما يلي فقط:
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.

يمكن إضافة 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.

يمكنك استهداف خيار واحد فقط لحالة البائع المعتمَد لكل مورد.

إذا لم يتضمن أحد الموارد خيار حالة البائع المعتمد، سيتم تلقائيًا استهداف جميع البائعين المعتمَدين الذين تمت الإشارة إليهم باعتبارهم "مباشر" أو "بائع" في ملف 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.

الفئات الإعلانية الحسّاسة هي استثناءات استهداف. يتم دائمًا تطبيق استبعادات الفئات الحسّاسة على مستوى المعلِن، في حال ضبطها، في عرض الإعلانات (على الرغم من أنّها لا تظهر في إعدادات الموارد). يمكن أن تستبعد إعدادات الموارد فئات إعلانية حساسة بالإضافة إلى استبعادات المعلنين، ولكن لا يمكنها تجاوزها.
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)

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

الطُرق

create

 تعيين خيار استهداف لشريك

delete

 حذف خيار استهداف معيّن من شريك

get

 يتمّ منح خيار استهداف واحد لشريك.

list

 يسرد خيارات الاستهداف المحدّدة لأحد الشركاء.