REST Resource: exchanges.publishers

منبع: ناشر

یک ناشر واحد را در بر می گیرد.

نمایندگی JSON 
{
  "name": string,
  "externalPublisherId": string,
  "externalPublisherIds": [
    string
  ],
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "mediumCapability": enum (MediumCapability),
  "description": string,
  "contactInfo": [
    string
  ],
  "commitmentCapability": [
    enum (CommitmentCapability)
  ],
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "ceilingPrice": {
    object (Money)
  },
  "generalCapability": string,
  "tvMetadata": {
    object (TVMetadata)
  },
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ]
}
فیلدها
name

string

فقط خروجی نام مسیر نسبی برای این ناشر. باید به این شکل باشد: "exchanges/{seller_id}/publishers/{publisherId} مثال: "exchanges/1234/publishers/5678".

externalPublisherId

string

مورد نیاز. [منسوخ شده] این فیلد به زودی با خارجیPublisherIds[] جایگزین خواهد شد. Exchange شناسه ناشر منحصربه‌فرد ارائه کرد. باید با شناسه ناشر ارسال شده در درخواست های پیشنهاد مطابقت داشته باشد.

حداکثر 100 کاراکتر کاراکترهای مجاز عبارتند از حروف عددی، زیرخط، خط تیره و نقطه.

externalPublisherIds[]

string

اختیاری. صرافی شناسه های ناشر را ارائه کرد. هر شناسه باید منحصر به فرد باشد و با شناسه ناشر ارسال شده در درخواست های پیشنهادی مطابقت داشته باشد.

حداکثر 10 شمارش حداکثر 100 کاراکتر در هر شناسه. کاراکترهای مجاز عبارتند از حروف عددی، زیرخط، خط تیره و نقطه.

displayName

string

مورد نیاز. نام نمایشی این ناشر. باید دارای کد UTF-8 با حداکثر اندازه 30 کاراکتر باشد.

status

enum ( DiscoveryObjectStatus )

مورد نیاز. وضعیت این ناشر ناشران با وضعیت موقت یا حذف شده به تبلیغ‌کنندگان DV3 نشان داده نمی‌شوند.

mediumCapability

enum ( MediumCapability )

مورد نیاز. رسانه ای که این ناشر قصد دارد تبلیغات خود را در آنها میزبانی کند.

description

string

مورد نیاز. متن توضیحات برای این ناشر. باید دارای کد UTF-8 با حداکثر اندازه 1000 کاراکتر باشد. مورد نیاز.

contactInfo[]

string

مورد نیاز. ایمیل‌های نقطه تماس تبلیغ‌کنندگان برای ارتباط با ناشر. حداکثر 10 مخاطب حداکثر هر مخاطب 100 کاراکتر. مثال: [تماس ایالات متحده - جان اسمیت: john.smith@abc.com]. مورد نیاز.

commitmentCapability[]

enum ( CommitmentCapability )

اختیاری. انواع تعهدی که این ناشر پشتیبانی می کند.

forecast

object ( SellerProvidedInventoryAvailabilityEstimate )

مورد نیاز. پیش‌بینی تفکیک موجودی این ناشر. تبلیغ‌کنندگان DV3 می‌توانند این تفکیک‌ها را ببینند و فیلتر کنند. خرابی پیش‌بینی دامنه مورد نیاز است.

logoUrl

string

فقط خروجی نشانی اینترنتی لوگوی این ناشر.

floorPrice

object ( Money )

اختیاری. قیمت کف این ناشر. باید رمز ارز یکسان با قیمت سقف داشته باشد.

ceilingPrice

object ( Money )

اختیاری. سقف قیمت این ناشر. باید کد ارز یکسان با قیمت کف داشته باشد.

generalCapability

string

اختیاری.

tvMetadata

object ( TVMetadata )

اختیاری. فراداده برای ناشر که دارای پیشنهادات تلویزیونی است. زمانی که قابلیت متوسط ​​شامل تلویزیون باشد، الزامی است. زمانی که قابلیت متوسط ​​شامل تلویزیون نباشد، کاربرد ندارد.

urgOwners[]

enum ( UnderRepresentedGroup )

اختیاری. در گروه‌های ارائه‌شده، مالک، در صورت وجود، عضوی است.

قابلیت متوسط

تعداد توانمندی متوسط ظاهر بازار (در ماژول موجودی DV360) شامل بخش‌های مختلفی برای موجودی است. «دیجیتال: این شامل ناشران و بسته‌های حراجی می‌شود که در سراسر نمایشگر، ویدیو (از جمله CTV و OTT) و موجودی صوتی را شامل می‌شود.» "تلویزیون: این بخش اختصاصی ما برای کشف موجودی CTV و OTT است که به تازگی راه اندازی شده است. CTV و OTT به صورت زیر تعریف می شوند: "تلویزیون متصل (CTV) شامل تمام دستگاه هایی است که با توضیحات زیر مطابقت دارند: - دستگاه های متصل یا پخش جریانی: دستگاه هایی که به صفحه تلویزیون برای نمایش جریان های ویدئویی (Roku، Apple TV و غیره) متصل می شوند - تلویزیون های هوشمند یکپارچه (Smart TV) و غیره. کنسول‌های بازی: کنسول‌های بازی متصل به اینترنت (ایکس‌باکس، پلی‌استیشن، Wii، و غیره) - جعبه‌های تنظیم: دستگاه‌هایی که محتوای کابلی و ویدیویی سنتی را بر اساس تقاضا ارائه می‌دهند.» «Over the Top (OTT) به معنای محتوای ویدیویی شبیه تلویزیون است که توسط یک ارائه‌دهنده ویدیو از طریق اینترنت در خارج از شبکه‌های بسته ارائه‌دهندگان مخابراتی و کابلی ارائه می‌شود. OTT Video را می توان در دسکتاپ، موبایل، تبلت، و همچنین دستگاه های CTV یا STB مشاهده کرد (تا زمانی که محتوا از طریق IP برای دستگاه دوم تحویل داده شود). "صوت: این بخش اختصاصی و تازه راه اندازی شده برای موجودی صوتی است." "OOH: ناشران دیجیتال خارج از خانه."

Enums
MEDIUM_CAPABILITY_UNSPECIFIED قابلیت متوسط ​​نامشخص ورودی معتبر نیست.
MEDIUM_CAPABILITY_DIGITAL دیجیتال با قابلیت متوسط
MEDIUM_CAPABILITY_TV تلویزیون با قابلیت متوسط
MEDIUM_CAPABILITY_AUDIO صدا با قابلیت متوسط
MEDIUM_CAPABILITY_OOH قابلیت متوسط ​​خارج از خانه.

قابلیت تعهد

تعداد قابلیت تعهد

Enums
COMMITMENT_CAPABILITY_UNSPECIFIED قابلیت تعهد نامشخص ورودی معتبر نیست.
COMMITMENT_CAPABILITY_GUARANTEED ناشر موجودی را تضمین کرده است.
COMMITMENT_CAPABILITY_NON_GUARANTEED ناشر موجودی غیر تضمینی دارد.

TVMetadata

فراداده برای ناشران که دارای پیشنهادات تلویزیونی هستند.

نمایندگی JSON 
{
  "tvDeliveryType": enum (TVDeliveryType),
  "topShows": [
    string
  ]
}
فیلدها
tvDeliveryType

enum ( TVDeliveryType )

مورد نیاز. نوع ارسال تبلیغات تلویزیونی

topShows[]

string

اختیاری. فهرست عناوین برتر برنامه های تلویزیونی متعلق به ناشر. حداکثر اندازه 10. باید با کد UTF-8 باشد.

TVDeliveryType

نوع تحویل تلویزیون enum.

Enums
TV_DELIVERY_TYPE_UNSPECIFIED نوع تحویل تلویزیون مشخص نشده است. ورودی معتبر نیست.
TV_DELIVERY_TYPE_CTV نوع تحویل تلویزیون تلویزیون متصل.
TV_DELIVERY_TYPE_LINEAR_TV تلویزیون خطی نوع تحویل تلویزیون.

روش ها

create

 یک ناشر جدید ایجاد می کند.

get

 ناشر می گیرد.

list

 ناشران را فهرست می کند.

patch

 یک ناشر را به روز می کند.
لوگوی ناشر را بارگذاری کنید.