- משאב: InventorySource
- InventorySourceType
- InventorySourceProductType
- InventorySourceCommitment
- InventorySourceDeliveryMethod
- InventorySourceStatus
- InventorySourceConfigStatus
- RateDetails
- InventorySourceRateType
- Money
- TimeRange
- CreativeConfig
- InventorySourceDisplayCreativeConfig
- InventorySourceVideoCreativeConfig
- InventorySourceAccessors
- PartnerAccessor
- AdvertiserAccessors
- שיטות
משאב: InventorySource
מקור מלאי.
ייצוג JSON |
---|
{ "name": string, "inventorySourceId": string, "displayName": string, "inventorySourceType": enum ( |
שדות | |
---|---|
name |
פלט בלבד. שם המשאב של מקור המלאי. |
inventory |
פלט בלבד. המזהה הייחודי של מקור המלאי. המערכת מקצה את השם. |
display |
השם המוצג של מקור המלאי. הקידוד חייב להיות UTF-8 והגודל המקסימלי הוא 240 בייטים. |
inventory |
מציין את הסוג של מקור המלאי. |
inventory |
פלט בלבד. סוג המוצר של מקור מלאי שטחי הפרסום, שמציין את האופן שבו הוא מוכר מלאי שטחי פרסום. |
commitment |
אם למקור מלאי שטחי הפרסום יש הצגה מובטחת או לא מובטחת. |
delivery |
שיטת ההעברה של מקור מלאי שטחי הפרסום.
|
deal |
המזהה במרחב של פלטפורמת ה-Exchange שמזהה באופן ייחודי את מקור מלאי שטחי הפרסום. המזהה צריך להיות ייחודי בקרב קונים בכל פלטפורמה, אבל לא בהכרח ייחודי בקרב פלטפורמות. |
status |
הגדרות הסטטוס של מקור המלאי. |
exchange |
פלטפורמת ה-Exchange שאליה שייך מקור מלאי שטחי הפרסום. |
update |
פלט בלבד. חותמת הזמן של מועד העדכון האחרון של מקור המלאי. המערכת מקצה את השם. חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
rate |
חובה. פרטי התעריפים של מקור המלאי. |
publisher |
שם בעל האפליקציה או אתר המכירה של מקור מלאי שטחי הפרסום. |
time |
טווח הזמן שבו מקור מלאי שטחי הפרסום הזה מתחיל להציג מודעות ומפסיק להציג אותן. |
creative |
הדרישות לגבי נכסי הקריאייטיב של מקור המלאי. ההגדרה לא רלוונטית לחבילות של מכרזים. |
guaranteed |
קבוע. המזהה של ההזמנה המובטחת שאליה שייך מקור המלאי הזה. האפשרות הזו רלוונטית רק כש- |
read |
השותפים או המפרסמים שיש להם הרשאת קריאה/כתיבה למקור מלאי שטחי הפרסום. הפלט מופיע רק כאשר חובה כשהערך של אם הערך של |
read |
פלט בלבד. המזהים של המפרסמים שיש להם הרשאת קריאה בלבד למקור מלאי שטחי הפרסום. |
read |
פלט בלבד. המזהים של שותפים שיש להם הרשאת קריאה בלבד למקור מלאי שטחי הפרסום. כל המפרסמים של שותפים בשדה הזה יורשים הרשאת קריאה בלבד למקור מלאי שטחי הפרסום. |
InventorySourceType
סוגי מקורות אפשריים של מלאי שטחי פרסום.
טיפוסים בני מנייה (enum) | |
---|---|
INVENTORY_SOURCE_TYPE_UNSPECIFIED |
סוג מקור מלאי שטחי הפרסום לא צוין או שהוא לא ידוע בגרסה הזו. |
INVENTORY_SOURCE_TYPE_PRIVATE |
מקור של מלאי פרטי. |
INVENTORY_SOURCE_TYPE_AUCTION_PACKAGE |
חבילת מכרז. |
InventorySourceProductType
סוגי המוצרים האפשריים של מקור מלאי.
טיפוסים בני מנייה (enum) | |
---|---|
INVENTORY_SOURCE_PRODUCT_TYPE_UNSPECIFIED |
סוג המוצר לא צוין או שהוא לא ידוע בגרסה הזו. אי אפשר לשנות את מקורות המלאי של סוג המוצר הזה דרך API. |
PREFERRED_DEAL |
מקור מלאי שטחי הפרסום מוכר מלאי שטחי פרסום באמצעות עסקה מועדפת. |
PRIVATE_AUCTION |
מקור מלאי שטחי הפרסום מוכר מלאי שטחי פרסום דרך מכרז פרטי. |
PROGRAMMATIC_GUARANTEED |
מקור מלאי שטחי הפרסום מוכר מלאי שטחי פרסום דרך קמפיינים פרוגרמטיים מובטחים. |
TAG_GUARANTEED |
מקור המלאי מוכר מלאי שטחי פרסום דרך Tag מובטח. |
YOUTUBE_RESERVE |
מקור מלאי שטחי הפרסום מוכר מלאי שטחי פרסום דרך YouTube Reserve. |
INSTANT_RESERVE |
מקור מלאי שטחי הפרסום מוכר מלאי שטחי פרסום באמצעות 'הזמנה מיידית'. אי אפשר לשנות את מקורות המלאי של סוג המוצר הזה באמצעות API. |
GUARANTEED_PACKAGE |
מקור מלאי שטחי הפרסום מוכר מלאי שטחי פרסום דרך חבילת שטחי פרסום מובטחת. אי אפשר לשנות את מקורות המלאי של סוג המוצר הזה באמצעות API. |
PROGRAMMATIC_TV |
מקור מלאי שטחי הפרסום מוכר מלאי שטחי פרסום דרך Programmtic TV. אי אפשר לשנות את מקורות המלאי של סוג המוצר הזה דרך API. |
AUCTION_PACKAGE |
מקור מלאי שטחי הפרסום מוכר מלאי שטחי פרסום באמצעות חבילה למכרז. אי אפשר לשנות את מקורות המלאי של סוג המוצר הזה דרך API. |
InventorySourceCommitment
סוגי ההתחייבויות האפשריים למקור מלאי שטחי פרסום.
טיפוסים בני מנייה (enum) | |
---|---|
INVENTORY_SOURCE_COMMITMENT_UNSPECIFIED |
ההתחייבות לא צוינה או לא ידועה בגרסה הזו. |
INVENTORY_SOURCE_COMMITMENT_GUARANTEED |
ההתחייבות היא למסירה מובטחת. |
INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED |
ההתחייבות היא למסירה ללא זמן חלון מובטח. |
InventorySourceDeliveryMethod
שיטות אפשריות להצגת מודעות למקור של מלאי שטחי פרסום.
טיפוסים בני מנייה (enum) | |
---|---|
INVENTORY_SOURCE_DELIVERY_METHOD_UNSPECIFIED |
שיטת המסירה לא צוינה או שהיא לא ידועה בגרסת הבקשה הזו. |
INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC |
שיטת ההעברה היא פרוגרמטית. |
INVENTORY_SOURCE_DELIVERY_METHOD_TAG |
שיטת ההעברה היא תג. |
InventorySourceStatus
ההגדרות שקשורות לסטטוס של מקור המלאי.
ייצוג JSON |
---|
{ "entityStatus": enum ( |
שדות | |
---|---|
entity |
האם ניתן להציג את מקור המלאי. הערכים הקבילים הם |
entity |
הסיבה שהמשתמש סיפק להשהיית מקור המלאי הזה. האורך המקסימלי הוא 100 תווים. רלוונטי רק כאשר בשדה |
seller |
פלט בלבד. הסטטוס שהמוכר הגדיר למקור מלאי שטחי הפרסום. האפשרות הזו רלוונטית רק למקורות מלאי שטחי פרסום שמסונכרנים ישירות מהבעלים של התוכן הדיגיטלי. הערכים הקבילים הם |
seller |
פלט בלבד. הסיבה שהמוכר ציין להשהיית מקור מלאי שטחי הפרסום הזה. האפשרות הזו רלוונטית רק למקורות מלאי שטחי הפרסום שמסונכרנים ישירות מבעלי האפליקציות, וכאשר הערך של |
config |
פלט בלבד. סטטוס ההגדרה של מקור המלאי. רלוונטי רק למקורות מלאי מובטח. הערכים הקבילים הם כדי להציג מודעות, צריך להגדיר מקור של מלאי שטחי פרסום (למלא את שדות החובה, לבחור נכסי קריאייטיב ולבחור קמפיין ברירת מחדל). |
InventorySourceConfigStatus
מצבי ההגדרה האפשריים של מקור מלאי שהובטח.
טיפוסים בני מנייה (enum) | |
---|---|
INVENTORY_SOURCE_CONFIG_STATUS_UNSPECIFIED |
סטטוס האישור לא צוין או לא ידוע בגרסה הזו. |
INVENTORY_SOURCE_CONFIG_STATUS_PENDING |
המצב ההתחלתי של מקור מלאי שטחי פרסום מובטח. צריך להגדיר את מקור המלאי במצב הזה. |
INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED |
המצב שאחרי הקונה מגדיר מקור מובטח של מלאי שטחי פרסום. |
RateDetails
ההגדרות שקשורות לשיעור של מקור מלאי שטחי הפרסום.
ייצוג ב-JSON |
---|
{ "inventorySourceRateType": enum ( |
שדות | |
---|---|
inventory |
סוג התעריף. הערכים הקבילים הם |
rate |
התעריף של מקור מלאי שטחי הפרסום. |
units |
חובה למקורות מלאי מובטחים. מספר החשיפות שמובטחות על ידי המוכר. |
minimum |
פלט בלבד. הסכום שהקונה התחייב להוציא מראש על מקור מלאי שטחי הפרסום. רלוונטי רק למקורות מלאי מובטח. |
InventorySourceRateType
סוגי תעריפים אפשריים למקור מלאי.
טיפוסים בני מנייה (enum) | |
---|---|
INVENTORY_SOURCE_RATE_TYPE_UNSPECIFIED |
סוג התעריף לא צוין או שהוא לא ידוע בגרסה הזו. |
INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED |
סוג התעריף הוא עלות לאלף חשיפות (קבועה). |
INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR |
סוג התעריף הוא עלות לאלף חשיפות (רצפה). |
INVENTORY_SOURCE_RATE_TYPE_CPD |
סוג המחיר הוא 'עלות ליום'. |
INVENTORY_SOURCE_RATE_TYPE_FLAT |
סוג התעריף הוא Flat. |
כסף
מייצג סכום כסף עם סוג המטבע שלו.
ייצוג ב-JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
שדות | |
---|---|
currency |
קוד המטבע בן שלוש האותיות שמוגדר בתקן ISO 4217. |
units |
מספר היחידות השלמות של הסכום. לדוגמה, אם הערך של |
nanos |
מספר יחידות הננו (10^-9) של הסכום. הערך חייב להיות בין -999,999,999 ל- +999,999,999, כולל. אם הערך של |
TimeRange
טווח זמן.
ייצוג JSON |
---|
{ "startTime": string, "endTime": string } |
שדות | |
---|---|
start |
חובה. הגבול התחתון של טווח זמן, כולל. חותמת זמן בפורמט 'Zulu' בפורמט RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה. דוגמאות: |
end |
חובה. הגבול העליון של טווח זמן, כולל. חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
CreativeConfig
הגדרת הדרישות לנכסי הקריאייטיב של מקור המלאי.
ייצוג JSON |
---|
{ "creativeType": enum ( |
שדות | |
---|---|
creative |
סוג הקריאייטיב שאפשר להקצות למקור המלאי. יש תמיכה רק בסוגים הבאים:
|
שדה האיחוד
ההגדרות של נכסי הקריאייטיב שאפשר להקצות למקור המלאי. הערך של |
|
display |
ההגדרה של נכסי הקריאייטיב לרשת המדיה. רלוונטי אם הערך של |
video |
ההגדרה של נכסי הקריאייטיב מסוג וידאו. רלוונטי אם הערך של |
InventorySourceDisplayCreativeConfig
ההגדרה של מודעות קריאייטיב לרשת המדיה.
ייצוג ב-JSON |
---|
{
"creativeSize": {
object ( |
שדות | |
---|---|
creative |
דרישות הגודל לקריאייטיבים לרשת המדיה שאפשר להקצות למקור המלאי. |
InventorySourceVideoCreativeConfig
ההגדרה של נכסי הקריאייטיב מסוג וידאו.
ייצוג ב-JSON |
---|
{ "duration": string } |
שדות | |
---|---|
duration |
הדרישות לגבי משך הזמן של נכסי הקריאייטיב בווידאו שאפשר להקצות למקור מלאי שטחי הפרסום. משך הזמן בשניות, עם עד תשע ספרות עשרוניות, שמסתיימים ב-' |
InventorySourceAccessors
השותף או המפרסמים שיש להם גישה למקור מלאי שטחי הפרסום.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה האיחוד accessors . השותף או המפרסמים שיש להם גישה למקור מלאי שטחי הפרסום. accessors יכול להיות רק אחת מהאפשרויות הבאות: |
|
partner |
השותף שיש לו גישה למקור מלאי שטחי הפרסום. |
advertisers |
המפרסמים שיש להם גישה למקור מלאי שטחי הפרסום. כל המפרסמים צריכים להשתייך לאותו שותף. |
PartnerAccessor
השותף שיש לו גישה למקור מלאי שטחי הפרסום.
ייצוג ב-JSON |
---|
{ "partnerId": string } |
שדות | |
---|---|
partner |
המזהה של השותף. |
AdvertiserAccessors
המפרסמים שיש להם גישה למקור מלאי שטחי הפרסום.
ייצוג JSON |
---|
{ "advertiserIds": [ string ] } |
שדות | |
---|---|
advertiser |
המזהים של המפרסמים. |
שיטות |
|
---|---|
|
יצירת מקור מלאי חדש. |
|
עריכת פונקציות גישה לקריאה/כתיבה של מקור מלאי שטחי פרסום. |
|
אחזור של מקור מלאי. |
|
רשימה של מקורות מלאי שטחי הפרסום שזמינים למשתמש הנוכחי. |
|
עדכון של מקור מלאי שטחי פרסום קיים. |