Display & Video 360 API v1beta2 غروب شده است. درخواستها به نسخه غروب ممکن است با خطا مواجه شوند.
باید از Display & Video 360 API v2 استفاده کنید. برای مراحل مهاجرت از نسخه 1 به نسخه 2 به راهنمای مهاجرت ما مراجعه کنید.
Method: targetingTypes.targetingOptions.list
با مجموعهها، منظم بمانید
ذخیره و دستهبندی محتوا براساس اولویتهای شما.
گزینه های هدف گیری از یک نوع مشخص را فهرست می کند.
درخواست HTTP
GET https://displayvideo.googleapis.com/v1beta2/targetingTypes/{targetingType}/targetingOptions
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های |
---|
targetingType | enum ( TargetingType ) ضروری. نوع گزینه هدف گذاری که باید فهرست شود. مقادیر پذیرفته شده عبارتند از: -
TARGETING_TYPE_APP_CATEGORY -
TARGETING_TYPE_AGE_RANGE -
TARGETING_TYPE_GENDER -
TARGETING_TYPE_VIDEO_PLAYER_SIZE -
TARGETING_TYPE_USER_REWARDED_CONTENT -
TARGETING_TYPE_PARENTAL_STATUS -
TARGETING_TYPE_CONTENT_INSTREAM_POSITION -
TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION -
TARGETING_TYPE_DEVICE_TYPE -
TARGETING_TYPE_BROWSER -
TARGETING_TYPE_HOUSEHOLD_INCOME -
TARGETING_TYPE_ON_SCREEN_POSITION -
TARGETING_TYPE_CARRIER_AND_ISP -
TARGETING_TYPE_OPERATING_SYSTEM -
TARGETING_TYPE_DEVICE_MAKE_MODEL -
TARGETING_TYPE_ENVIRONMENT -
TARGETING_TYPE_CATEGORY -
TARGETING_TYPE_VIEWABILITY -
TARGETING_TYPE_AUTHORIZED_SELLER_STATUS -
TARGETING_TYPE_LANGUAGE -
TARGETING_TYPE_GEO_REGION -
TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION -
TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION -
TARGETING_TYPE_EXCHANGE -
TARGETING_TYPE_SUB_EXCHANGE -
TARGETING_TYPE_NATIVE_CONTENT_POSITION -
TARGETING_TYPE_OMID
|
پارامترهای پرس و جو
مولفه های |
---|
advertiserId | string ( int64 format) ضروری. تبلیغ کننده این درخواست در زمینه انجام می شود. |
pageSize | integer اندازه صفحه درخواستی باید بین 1 تا 100 باشد. اگر نامشخص باشد به طور پیش فرض 100 خواهد بود. اگر مقدار نامعتبری مشخص شده باشد، کد خطا INVALID_ARGUMENT را برمیگرداند. |
pageToken | string نشانه ای که صفحه ای از نتایجی را که سرور باید برگرداند، شناسایی کند. به طور معمول، این مقدار nextPageToken است که از فراخوانی قبلی به روش targetingOptions.list بازگردانده می شود. اگر مشخص نشده باشد، صفحه اول نتایج برگردانده خواهد شد. |
orderBy | string فیلدی که بر اساس آن لیست مرتب می شود. مقادیر قابل قبول عبارتند از: -
targetingOptionId (پیشفرض)
ترتیب مرتب سازی پیش فرض صعودی است. برای تعیین ترتیب نزولی برای یک فیلد، پسوند "desc" باید به نام فیلد اضافه شود. مثال: targetingOptionId desc . |
filter | string اجازه می دهد تا با هدف قرار دادن ویژگی های گزینه فیلتر شود. نحو پشتیبانی شده: - عبارات فیلتر از یک یا چند محدودیت تشکیل شده اند.
- محدودیت ها را می توان با عملگرهای منطقی
OR ترکیب کرد. - یک محدودیت به شکل
{field} {operator} {value} است. - عملگر باید "=" (علامت مساوی) باشد.
- زمینه های پشتیبانی شده:
-
carrierAndIspDetails.type -
geoRegionDetails.geoRegionType -
targetingOptionId
مثال ها: - همه گزینههای هدف
GEO REGION که به زیر نوع GEO_REGION_TYPE_COUNTRY یا GEO_REGION_TYPE_STATE تعلق دارند: geoRegionDetails.geoRegionType="GEO_REGION_TYPE_COUNTRY" OR geoRegionDetails.geoRegionType="GEO_REGION_TYPE_STATE" - همه گزینههای هدفگیری
CARRIER AND ISP که به نوع فرعی CARRIER_AND_ISP_TYPE_CARRIER تعلق دارند: carrierAndIspDetails.type="CARRIER_AND_ISP_TYPE_CARRIER" .
طول این فیلد نباید بیشتر از 500 کاراکتر باشد. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"targetingOptions": [
{
object (TargetingOption )
}
],
"nextPageToken": string
} |
زمینه های |
---|
targetingOptions[] | object ( TargetingOption ) لیست گزینه های هدف گیری در صورت خالی بودن این لیست وجود نخواهد داشت. |
nextPageToken | string نشانه ای برای بازیابی صفحه بعدی نتایج. این مقدار را در قسمت pageToken در فراخوانی بعدی به روش targetingOptions.list ارسال کنید تا صفحه بعدی نتایج را بازیابی کنید. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/display-video
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2023-12-02 بهوقت ساعت هماهنگ جهانی.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"اطلاعاتی که نیاز دارم وجود ندارد"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"بیشازحد پیچیده/ مراحل بسیار زیاد"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"قدیمی"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"مشکل ترجمه"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"مشکل کد / نمونهها"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"غیره"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"درک آسان"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"مشکلم را برطرف کرد"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"غیره"
}]