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

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

حداکثر ۱۰۰ کاراکتر. کاراکترهای مجاز شامل حروف و اعداد، زیرخط، خط تیره و نقطه هستند.

externalPublisherIds[]

string

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

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

displayName

string

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

status

enum ( DiscoveryObjectStatus )

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

mediumCapability

enum ( MediumCapability )

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

description

string

الزامی. متن توضیحات برای این ناشر. باید با کدگذاری UTF-8 و حداکثر اندازه ۱۰۰۰ کاراکتر باشد.

contactInfo[]

string

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

commitmentCapability[]

enum ( CommitmentCapability )

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

forecast

object ( SellerProvidedInventoryAvailabilityEstimate )

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

logoUrl

string

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

floorPrice

object ( Money )

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

ceilingPrice

object ( Money )

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

generalCapability

string

اختیاری. توضیحات کلی به صورت متن آزاد. باید با کدگذاری UTF-8 و حداکثر اندازه ۲۰۰ کاراکتر باشد. این توضیحات می‌تواند شامل SOV (اشتراک صدا)، CPD، تضمین حجم صدا باشد. مثال توضیحات: CPD, High Impact, 69% avg. viewability

tvMetadata

object ( TVMetadata )

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

urgOwners[]

enum ( UnderRepresentedGroup )

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

قابلیت متوسط

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

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

تعهدقابلیت

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

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

تلویزیونفراداده

فراداده برای ناشرانی که برنامه‌های تلویزیونی ارائه می‌دهند.

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

enum ( TVDeliveryType )

الزامی. نوع ارائه تبلیغات تلویزیونی.

topShows[]

string

اختیاری. فهرست برترین عناوین برنامه‌های تلویزیونی متعلق به ناشر. حداکثر حجم ۱۰. باید با کدگذاری UTF-8 باشد.

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

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

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

روش‌ها

create

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

get

ناشر پیدا می‌کند.

list

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

patch

یک ناشر را به‌روزرسانی می‌کند.
لوگوی ناشر را آپلود می‌کند.
،

منبع: ناشر

یک ناشر واحد را کپسوله‌سازی می‌کند.

نمایش 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

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

حداکثر ۱۰۰ کاراکتر. کاراکترهای مجاز شامل حروف و اعداد، زیرخط، خط تیره و نقطه هستند.

externalPublisherIds[]

string

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

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

displayName

string

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

status

enum ( DiscoveryObjectStatus )

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

mediumCapability

enum ( MediumCapability )

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

description

string

الزامی. متن توضیحات برای این ناشر. باید با کدگذاری UTF-8 و حداکثر اندازه ۱۰۰۰ کاراکتر باشد.

contactInfo[]

string

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

commitmentCapability[]

enum ( CommitmentCapability )

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

forecast

object ( SellerProvidedInventoryAvailabilityEstimate )

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

logoUrl

string

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

floorPrice

object ( Money )

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

ceilingPrice

object ( Money )

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

generalCapability

string

اختیاری. توضیحات کلی به صورت متن آزاد. باید با کدگذاری UTF-8 و حداکثر اندازه ۲۰۰ کاراکتر باشد. این توضیحات می‌تواند شامل SOV (اشتراک صدا)، CPD، تضمین حجم صدا باشد. مثال توضیحات: CPD, High Impact, 69% avg. viewability

tvMetadata

object ( TVMetadata )

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

urgOwners[]

enum ( UnderRepresentedGroup )

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

قابلیت متوسط

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

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

تعهدقابلیت

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

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

تلویزیونفراداده

فراداده برای ناشرانی که برنامه‌های تلویزیونی ارائه می‌دهند.

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

enum ( TVDeliveryType )

الزامی. نوع ارائه تبلیغات تلویزیونی.

topShows[]

string

اختیاری. فهرست برترین عناوین برنامه‌های تلویزیونی متعلق به ناشر. حداکثر حجم ۱۰. باید با کدگذاری UTF-8 باشد.

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

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

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

روش‌ها

create

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

get

ناشر پیدا می‌کند.

list

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

patch

یک ناشر را به‌روزرسانی می‌کند.
لوگوی ناشر را آپلود می‌کند.
،

منبع: ناشر

یک ناشر واحد را کپسوله‌سازی می‌کند.

نمایش 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

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

حداکثر ۱۰۰ کاراکتر. کاراکترهای مجاز شامل حروف و اعداد، زیرخط، خط تیره و نقطه هستند.

externalPublisherIds[]

string

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

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

displayName

string

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

status

enum ( DiscoveryObjectStatus )

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

mediumCapability

enum ( MediumCapability )

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

description

string

الزامی. متن توضیحات برای این ناشر. باید با کدگذاری UTF-8 و حداکثر اندازه ۱۰۰۰ کاراکتر باشد.

contactInfo[]

string

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

commitmentCapability[]

enum ( CommitmentCapability )

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

forecast

object ( SellerProvidedInventoryAvailabilityEstimate )

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

logoUrl

string

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

floorPrice

object ( Money )

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

ceilingPrice

object ( Money )

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

generalCapability

string

اختیاری. توضیحات کلی به صورت متن آزاد. باید با کدگذاری UTF-8 و حداکثر اندازه ۲۰۰ کاراکتر باشد. این توضیحات می‌تواند شامل SOV (اشتراک صدا)، CPD، تضمین حجم صدا باشد. مثال توضیحات: CPD, High Impact, 69% avg. viewability

tvMetadata

object ( TVMetadata )

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

urgOwners[]

enum ( UnderRepresentedGroup )

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

قابلیت متوسط

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

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

تعهدقابلیت

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

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

تلویزیونفراداده

فراداده برای ناشرانی که برنامه‌های تلویزیونی ارائه می‌دهند.

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

enum ( TVDeliveryType )

الزامی. نوع ارائه تبلیغات تلویزیونی.

topShows[]

string

اختیاری. فهرست برترین عناوین برنامه‌های تلویزیونی متعلق به ناشر. حداکثر حجم ۱۰. باید با کدگذاری UTF-8 باشد.

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

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

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

روش‌ها

create

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

get

ناشر پیدا می‌کند.

list

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

patch

یک ناشر را به‌روزرسانی می‌کند.
لوگوی ناشر را آپلود می‌کند.
،

منبع: ناشر

یک ناشر واحد را کپسوله‌سازی می‌کند.

نمایش 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

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

حداکثر ۱۰۰ کاراکتر. کاراکترهای مجاز شامل حروف و اعداد، زیرخط، خط تیره و نقطه هستند.

externalPublisherIds[]

string

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

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

displayName

string

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

status

enum ( DiscoveryObjectStatus )

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

mediumCapability

enum ( MediumCapability )

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

description

string

الزامی. متن توضیحات برای این ناشر. باید با کدگذاری UTF-8 و حداکثر اندازه ۱۰۰۰ کاراکتر باشد.

contactInfo[]

string

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

commitmentCapability[]

enum ( CommitmentCapability )

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

forecast

object ( SellerProvidedInventoryAvailabilityEstimate )

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

logoUrl

string

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

floorPrice

object ( Money )

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

ceilingPrice

object ( Money )

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

generalCapability

string

اختیاری. توضیحات کلی به صورت متن آزاد. باید با کدگذاری UTF-8 و حداکثر اندازه ۲۰۰ کاراکتر باشد. این توضیحات می‌تواند شامل SOV (اشتراک صدا)، CPD، تضمین حجم صدا باشد. مثال توضیحات: CPD, High Impact, 69% avg. viewability

tvMetadata

object ( TVMetadata )

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

urgOwners[]

enum ( UnderRepresentedGroup )

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

قابلیت متوسط

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

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

تعهدقابلیت

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

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

تلویزیونفراداده

فراداده برای ناشرانی که برنامه‌های تلویزیونی ارائه می‌دهند.

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

enum ( TVDeliveryType )

الزامی. نوع ارائه تبلیغات تلویزیونی.

topShows[]

string

اختیاری. فهرست برترین عناوین برنامه‌های تلویزیونی متعلق به ناشر. حداکثر حجم ۱۰. باید با کدگذاری UTF-8 باشد.

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

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

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

روش‌ها

create

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

get

ناشر پیدا می‌کند.

list

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

patch

یک ناشر را به‌روزرسانی می‌کند.
لوگوی ناشر را آپلود می‌کند.