REST Resource: exchanges.orders.products

מקור מידע: מוצר

מוצר

ייצוג ב-JSON 
{
  "name": string,
  "displayName": string,
  "externalDealId": string,
  "transactionType": enum (TransactionType),
  "pricingType": enum (PricingType),
  "updateTime": string,
  "startTime": string,
  "endTime": string,
  "rateDetails": {
    object (RateDetails)
  },
  "creativeConfig": [
    {
      object (CreativeConfig)
    }
  ],
  "makegood": boolean,
  "makegoodDetails": {
    object (MakegoodDetails)
  },
  "creativeSource": enum (CreativeSource),
  "mediumType": enum (MediumType),
  "audienceTargetingConfig": {
    object (AudienceTargetingConfig)
  },
  "targetingCriteria": {
    object (TargetingCriteria)
  },
  "forecastResult": {
    object (ForecastResult)
  },
  "errorDetails": {
    object (ErrorDetails)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "program": string,
  "buyerCustomParameters": {
    string: string,
    ...
  },
  "etag": string
}
שדות
name

string

שם המשאב היחסי של המוצר. נוצר על ידי השרת. לדוגמה: "exchanges/1234/orders/5678/products/abc". פלט בלבד.
displayName

string

השם המוצג של המוצר.

הערך חייב להיות מקודד ב-UTF-8 ובגודל של עד 240 בייטים. חובה.
externalDealId

string

מזהה חיצוני. זהו מספר העסקה במערכת Exchange. עד 100 תווים. התווים המותרים הם תווים אלפאנומריים, קו תחתון, מקף ונקודה. המזהה חייב להיות ייחודי בכל המוצרים. חובה.
transactionType

enum (TransactionType)

סוג העסקה של המוצר. חובה.
pricingType

enum (PricingType)

סוג התמחור של המוצר. חובה.
updateTime
(deprecated)

string (Timestamp format)

חותמת הזמן של מועד העדכון האחרון של המוצר.

השימוש הוא ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
startTime

string (Timestamp format)

השעה שבה המוצר הזה הופך לפעיל. חייב להיות מוקדם יותר מ-endTime. שעת ההתחלה לא יכולה להיות בעוד יותר משנה. חובה.

השימוש הוא ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

המועד שבו המוצר הזה הופך ללא פעיל. התאריך לא יכול להיות אחרי שנת 2036. חובה.

השימוש הוא ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
rateDetails

object (RateDetails)

פרטי התעריף. חובה.
creativeConfig[]

object (CreativeConfig)

הדרישות בנוגע לקריאייטיב של מוצר. חובה למוצרים מסוג עסקה שמורה.
makegood
(deprecated)

boolean

מציין אם המוצר הוא מוצר פיצוי.
makegoodDetails
(deprecated)

object (MakegoodDetails)

פרטי הצגה חוזרת לפיצוי על מוצר. חובה כשהמוצר הוא הצגה חוזרת לפיצוי.
creativeSource

enum (CreativeSource)

מקור הקריאייטיב של מוצר. אופציונלי, ברירת המחדל היא CREATIVE_SOURCE_ADVERTISER. אי אפשר לשנות את ההגדרה הזו אחרי שיוצרים את המוצר.
mediumType

enum (MediumType)

סוג המדיה של המוצר. אם לא מציינים ערך, ברירת המחדל היא DIGITAL, כדי לשמור על תאימות לדורות קודמים. אי אפשר לשנות את ההגדרה הזו אחרי שיוצרים את המוצר.
audienceTargetingConfig

object (AudienceTargetingConfig)

אופציונלי. הגדרת הטירגוט לפי קהל הוחלה ברמת העסקה בבורסה.
targetingCriteria

object (TargetingCriteria)

פלט בלבד. הפניות לקריטריונים לטירגוט מוצרים. רלוונטי רק לתרחישים של עסקה מיידית.
forecastResult

object (ForecastResult)

תוצאות של תחזית מוצרים. חובה כשהקריטריונים לטירגוט לא ריקים והתחזית לא מסופקת. רלוונטי רק לתרחישים של עסקה מיידית.
errorDetails

object (ErrorDetails)

אם אי אפשר לעדכן שדות ספציפיים של מוצרים, צריך לציין את פרטי השגיאה. חובה כשאי אפשר לספק את תוצאת התחזית בגלל קריטריון טירגוט, או כשאי אפשר לעדכן את המוצר. רלוונטי רק לתרחישים של עסקה מיידית.
frequencyCap

object (FrequencyCap)

פלט בלבד. מכסת התדירות שהקונה בחר. רלוונטי רק לתרחישים של עסקה מיידית.
program

string

פלט בלבד. התוכנית שבה הקונה יצר את העסקה המיידית. אם אתם רוצים שההחלפה תתבצע כרגיל, אל תמלאו את השדה הזה. רלוונטי רק לתרחישים של עסקה מיידית.
buyerCustomParameters

map (key: string, value: string)

פלט בלבד. פרמטרים מותאמים אישית של מפתח/ערך שהקונה הגדיר בבקשה לעסקה מיידית. רלוונטי רק לתרחישים של עסקה מיידית.

אובייקט שמכיל רשימה של זוגות "key": value. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
etag

string

תג ישות (etag) שצריך לציין כשמעדכנים מוצר. צריך לציין אותו רק לעדכון אם השדה etag לא ריק. רלוונטי רק לתרחישים של עסקאות מיידיות.

CreativeConfig

הגדרת דרישות הקריאייטיב למוצר.

ייצוג ב-JSON 
{
  "creativeType": enum (CreativeType),
  "dimensionCreativeConfig": {
    object (DimensionCreativeConfig)
  },
  "durationCreativeConfig": {
    object (DurationCreativeConfig)
  }
}
שדות
creativeType

enum (CreativeType)

סוג הקריאייטיב. חובה.
dimensionCreativeConfig

object (DimensionCreativeConfig)

ההגדרות של הקריאייטיבים לרשת המדיה. השדה הזה לא נתמך בקריאייטיבים מותאמים (CREATIVE_TYPE_NATIVE).
durationCreativeConfig

object (DurationCreativeConfig)

ההגדרות של נכסי הקריאייטיב בווידאו.

CreativeType

סוגי קריאייטיב אפשריים.

טיפוסים בני מנייה (enum)
CREATIVE_TYPE_UNSPECIFIED לא צוין סוג הקריאייטיב. ערך הקלט לא חוקי.
CREATIVE_TYPE_DISPLAY סוג הקריאייטיב של המודעה לרשת המדיה.
CREATIVE_TYPE_VIDEO סוג הקריאייטיב של הסרטון.
CREATIVE_TYPE_AUDIO סוג הקריאייטיב של האודיו.
CREATIVE_TYPE_NATIVE סוג הקריאייטיב של המודעה המותאמת. אין תמיכה במוצרים עם סוג העסקה RESERVED.

DimensionCreativeConfig

מידות הקריאייטיב לרשת המדיה בפיקסלים.

ייצוג ב-JSON 
{
  "width": integer,
  "height": integer
}
שדות
width

integer

רוחב הקריאייטיב לרשת המדיה. חובה.
height

integer

גובה הקריאייטיב לרשת המדיה. חובה.

DurationCreativeConfig

ההגדרה של משך הקריאייטיב.

ייצוג ב-JSON 
{
  "duration": string,
  "durationMatchType": enum (DurationMatchType),
  "skippableMatchType": enum (SkippableMatchType)
}
שדות
duration

string (Duration format)

משך הזמן של קריאייטיב הווידאו בשניות. חובה

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-"s". לדוגמה: "3.5s".
durationMatchType

enum (DurationMatchType)

קריטריוני ההתאמה של משך הזמן.
skippableMatchType

enum (SkippableMatchType)

הסוג של קריאייטיב וידאו שניתן לדלג עליו.

DurationMatchType

קריטריונים להתאמה של משך הקריאייטיב של הווידאו.

טיפוסים בני מנייה (enum)
DURATION_MATCH_TYPE_UNSPECIFIED הקריטריון להתאמת משך הזמן לא צוין או לא ידוע בגרסה הזו. ערך הקלט לא חוקי.
DURATION_MATCH_TYPE_EQUAL_TO משך הקריאייטיב צריך להיות זהה למשך הנדרש.
DURATION_MATCH_TYPE_LESS_THAN_OR_EQUAL_TO משך הקריאייטיב צריך להיות זהה למשך הנדרש או קצר ממנו.

SkippableMatchType

קריטריונים להתאמה שקובעים אם אפשר לדלג על קריאייטיב של מודעת וידאו.

טיפוסים בני מנייה (enum)
SKIPPABLE_MATCH_TYPE_UNSPECIFIED סוג הניתן לדילוג לא צוין או לא ידוע בגרסה הזו. ערך הקלט לא חוקי.
SKIPPABLE_MATCH_TYPE_SKIPPABLE הקריאייטיב צריך להיות ניתן לדילוג.
SKIPPABLE_MATCH_TYPE_NOT_SKIPPABLE הקריאייטיב צריך להיות ללא אפשרות דילוג.
SKIPPABLE_MATCH_TYPE_ANY הקריאייטיב יכול להיות ניתן לדילוג או לא ניתן לדילוג.

MakegoodDetails

ההגדרות של פרטי הפיצוי.

ייצוג ב-JSON 
{
  "originalExternalDealId": string,
  "reason": string
}
שדות
originalExternalDealId

string

מספר העסקה החיצוני המקורי שבו נדרש פיצוי. עד 100 תווים. התווים המותרים הם תווים אלפאנומריים, קו תחתון, מקף ונקודה. חובה.
reason

string

סיבת ההצגה החוזרת לפיצוי ביוזמת בית העסק. עד 250 תווים. חובה.

CreativeSource

מקור הקריאייטיב: המקום שממנו יוצגו נכסי הקריאייטיב.

טיפוסים בני מנייה (enum)
CREATIVE_SOURCE_UNSPECIFIED מקור הקריאייטיב לא צוין או לא ידוע בגרסה הזו. ערך הקלט לא חוקי.
CREATIVE_SOURCE_ADVERTISER נכסי הקריאייטיב יוצגו על ידי DV3.
CREATIVE_SOURCE_PUBLISHER בעל האפליקציה יציג את נכסי הקריאייטיב. בשלב הזה אין תמיכה בקריאייטיבים שמתארחים אצל בעל התוכן הדיגיטלי. כל בקשה להגדיר את מקור הקריאייטיב כ-CREATIVE_SOURCE_PUBLISHER תיכשל.

AudienceTargetingConfig

ההגדרות של הטירגוט לפי קהל.

ייצוג ב-JSON 
{
  "audienceType": enum (AudienceType)
}
שדות
audienceType

enum (AudienceType)

סוג הקהל. חובה.

AudienceType

סוג הקהל.

טיפוסים בני מנייה (enum)
AUDIENCE_TYPE_UNSPECIFIED סוג הקהל לא צוין. הקלט לא תקין.
AUDIENCE_TYPE_COMMERCE סוג קהל מסחרי.

TargetingCriteria

קריטריונים של טירגוט שצוינו.

ייצוג ב-JSON 
{
  "selectedTargetingOptions": [
    {
      object (SelectedTargetingOption)
    }
  ]
}
שדות
selectedTargetingOptions[]

object (SelectedTargetingOption)

האפשרויות שנבחרו.

SelectedTargetingOption

אפשרות הטירגוט או אפשרויות הטירגוט שנבחרו לסוג טירגוט אחד.

ייצוג ב-JSON 
{
  "type": enum (TargetingType),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "audienceSelection": {
    object (AudienceSelection)
  },
  "targetingSelection": {
    object (TargetingSelection)
  }
  // End of mutually exclusive fields.
}
שדות
type

enum (TargetingType)

סוג הטירגוט שמשויך לאפשרויות שנבחרו.
אפשר לכלול רק סוג אחד של בחירה. האפשרות שנבחרה צריכה להתאים ל-TargetingType שנבחר בשדה type. זו רשימה של שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
audienceSelection

object (AudienceSelection)

הקהל שבחרת.
targetingSelection

object (TargetingSelection)

קבוצה כללית של מזהי אפשרויות שנבחרו.
סוף השדות שמוציאים זה את זה.

TargetingType

סוגי טירגוט.

טיפוסים בני מנייה (enum)
TARGETING_TYPE_UNSPECIFIED סוג הטירגוט לא צוין, לא חוקי לקלט.
TARGETING_TYPE_AUDIENCE קהל מסוג טירגוט.
TARGETING_TYPE_COUNTRY סוג טירגוט: מדינה.
TARGETING_TYPE_DMA סוג הטירגוט: אזור מטרופולין (DMA).
TARGETING_TYPE_PROGRAMMER סוג הטירגוט: מתכנת.
TARGETING_TYPE_BRAND סוג הטירגוט: מותג.
TARGETING_TYPE_CONTENT_GENRE סוג הטירגוט: ז'אנר התוכן.
TARGETING_TYPE_DEVICE סוג הטירגוט: מכשיר.
TARGETING_TYPE_OPERATING_SYSTEM סוג הטירגוט: מערכת הפעלה.
TARGETING_TYPE_RATING דירוג סוג הטירגוט.
TARGETING_TYPE_ENVIRONMENT סביבת סוג הטירגוט.
TARGETING_TYPE_LANGUAGE שפת סוג הטירגוט.
TARGETING_TYPE_GEO סוג הטירגוט: מיקום גיאוגרפי.
TARGETING_TYPE_AGE סוג הטירגוט: גיל.
TARGETING_TYPE_GENDER סוג הטירגוט: מגדר.
TARGETING_TYPE_CONTEXTUAL_SEGMENT פלח הקשרי של סוג הטירגוט.
TARGETING_TYPE_REQUEST_FORMAT פורמט הבקשה של סוג הטירגוט.
TARGETING_TYPE_PUBLISHER סוג הטירגוט של בעל התוכן הדיגיטלי.
TARGETING_TYPE_INVENTORY_SIZE גודל סוג הטירגוט.
TARGETING_TYPE_NETWORK רשת מסוג טירגוט.
TARGETING_TYPE_PLATFORM פלטפורמה של סוג טירגוט.
TARGETING_TYPE_VIDEO_DELIVERY_TYPE סוג טירגוט: סוג של הצגת סרטונים.
TARGETING_TYPE_VIDEO_MINIMUM_PLAYER_SIZE גודל מינימלי של נגן הווידאו לפי סוג הטירגוט.
TARGETING_TYPE_VIDEO_COMPLETION סוג הטירגוט: מיקום מודעת וידאו.
TARGETING_TYPE_VIEWABILITY ניראות לפי סוג הטירגוט.
TARGETING_TYPE_REWARDED סוג הטירגוט: מודעות מתגמלות.
TARGETING_TYPE_VIDEO_AD_DURATION_THRESHOLD_SEC סוג הטירגוט: סף משך הזמן של מודעת הווידאו בשניות.
TARGETING_TYPE_VIDEO_PLACEMENT סוג הטירגוט: מיקום מודעת וידאו.
TARGETING_TYPE_VIDEO_PLAYBACK_METHOD שיטת הפעלת הסרטון לפי סוג הטירגוט.
TARGETING_TYPE_APP_ID מזהה האפליקציה של סוג הטירגוט.
TARGETING_TYPE_DOMAIN_URL כתובת ה-URL של הדומיין של סוג הטירגוט.
TARGETING_TYPE_CTR שיעור הקליקים לפי סוג הטירגוט.
TARGETING_TYPE_DEMOGRAPHICS סוג טירגוט: קבוצות דמוגרפיות.
TARGETING_TYPE_RESTRICTED_CATEGORY קטגוריה מוגבלת של סוג טירגוט.
TARGETING_TYPE_AD_POSITION מיקום המודעה בדף לפי סוג הטירגוט.
TARGETING_TYPE_DAY_AND_TIME סוג הטירגוט, היום והשעה.
TARGETING_TYPE_RETAIL_MEDIA_AUDIENCE סוג הטירגוט: קהל של שיווק בנקודת רכישה.

AudienceSelection

אפשרויות נבחרות של טירגוט לפי קהל.

ייצוג ב-JSON 
{
  "includedOrGroups": [
    {
      object (OrGroup)
    }
  ],
  "excludedOptionIds": [
    string
  ]
}
שדות
includedOrGroups[]

object (OrGroup)

האפשרויות הכלולות מקושרות באמצעות AND, וכל אפשרות כלולה יכולה להיות אפשרות נפרדת או קבוצה של אפשרויות שמקושרות באמצעות OR.
excludedOptionIds[]

string (int64 format)

האפשרויות שהוחרגו מקושרות באמצעות OR.

OrGroup

קבוצה של אפשרויות שנבחרו, עם הקשר של OR.

ייצוג ב-JSON 
{
  "optionIds": [
    string
  ]
}
שדות
optionIds[]

string (int64 format)

מזהי האפשרויות שנבחרו.

TargetingSelection

אפשרויות טירגוט שנבחרו והוחרגו, שרלוונטיות לרוב סוגי הטירגוט.

ייצוג ב-JSON 
{
  "optionIds": [
    string
  ],
  "externalIds": [
    string
  ],
  "excludedOptionIds": [
    string
  ],
  "excludedExternalIds": [
    string
  ]
}
שדות
optionIds[]

string (int64 format)

פלט בלבד. מזהי אפשרויות הטירגוט שנבחרו ב-DV360 ושותפו עם הבורסה. יכול להיות שיוחזר לצד excludedOptionIds, כל עוד שתי הרשימות לא חופפות.
externalIds[]

string

פלט בלבד. מזהי אפשרויות הטירגוט שנבחרו, שסופקו על ידי הבורסה. יכול להיות שיוחזר לצד excludedExternalIds, כל עוד שתי הרשימות לא חופפות.
excludedOptionIds[]

string (int64 format)

פלט בלבד. מזהי אפשרויות הטירגוט של DV3 שלא נכללים, ששותפו עם בורסת הפרסום. יכול להיות שיוחזר לצד optionIds, כל עוד שתי הרשימות לא חופפות.
excludedExternalIds[]

string

פלט בלבד. מזהים של אפשרויות טירגוט שהוחרגו, שסופקו על ידי ה-Exchange. יכול להיות שיוחזר לצד externalIds, כל עוד שתי הרשימות לא חופפות.

ForecastResult

תוצאת התחזית שצוינה.

ייצוג ב-JSON 
{
  "forecasts": [
    {
      object (Forecast)
    }
  ]
}
שדות
forecasts[]

object (Forecast)

תחזית. הערך של forecastCategory חייב להיות ייחודי לכל רכיב שצוין.

תחזית

תחזית של קטגוריית התחזית שצוינה.

ייצוג ב-JSON 
{
  "forecastCategory": enum (ForecastCategory),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "number": string,
  "percentage": integer,
  "cpmPrice": {
    object (Money)
  },
  "cpmRange": {
    object (CpmRange)
  },
  "forecastBreakdownData": {
    object (ForecastBreakdownData)
  }
  // End of mutually exclusive fields.
}
שדות
forecastCategory

enum (ForecastCategory)

קטגוריית התחזית שצוינה, שהנתון הסטטיסטי של התחזית מייצג.
אפשר לכלול רק סוג אחד של נתונים סטטיסטיים. הנתונים שמאוכלסים צריכים להתאים לשדה forecastCategory. זו רשימה של שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
number

string (int64 format)

נתונים מספריים.
percentage

integer

נתונים באחוזים.
cpmPrice

object (Money)

נתוני מחירים של עלות לאלף חשיפות.
cpmRange

object (CpmRange)

נתונים על טווח המחירים של עלות לאלף חשיפות.
forecastBreakdownData

object (ForecastBreakdownData)

נתוני פירוט התחזית.
סוף השדות שמוציאים זה את זה.

ForecastCategory

קטגוריית התחזית.

טיפוסים בני מנייה (enum)
FORECAST_CATEGORY_UNSPECIFIED קטגוריה לא מוגדרת. הקלט לא תקין.
FORECAST_CATEGORY_TOTAL_OPPORTUNITIES סה"כ הזדמנויות. נתונים מספריים.
FORECAST_CATEGORY_TOTAL_AUDIENCE כל הקהל. נתונים מספריים.
FORECAST_CATEGORY_DIGITAL_TRP נקודות רייטינג בקהל היעד בדיגיטל. נתונים באחוזים.
FORECAST_CATEGORY_SUGGESTED_CPM הצעה לעלות לאלף חשיפות. טווח עלות לאלף חשיפות או נתוני מחיר של עלות לאלף חשיפות.
FORECAST_CATEGORY_UNIQUE_REACH תחזית של היקף החשיפה למשתמשים ייחודיים. נתונים מספריים.
FORECAST_CATEGORY_FORECAST_BREAKDOWN פירוט התחזית. נתוני פירוט התחזית.

CpmRange

טווח העלות לאלף חשיפות מכיל את העלות המינימלית והמקסימלית לאלף חשיפות.

ייצוג ב-JSON 
{
  "minCpm": {
    object (Money)
  },
  "maxCpm": {
    object (Money)
  }
}
שדות
minCpm

object (Money)

הגבול התחתון של טווח העלות לאלף חשיפות.
maxCpm

object (Money)

הגבול העליון של טווח העלות לאלף חשיפות.

ForecastBreakdownData

נתוני פירוט התחזית מכילים רשימה של פירוט התחזית.

ייצוג ב-JSON 
{
  "forecastBreakdowns": [
    {
      object (ForecastBreakdown)
    }
  ]
}
שדות
forecastBreakdowns[]

object (ForecastBreakdown)

רשימה של פירוטי תחזיות.

ForecastBreakdown

פירוט התחזית של אפשרות הטירגוט שנבחרה.

ייצוג ב-JSON 
{
  "selectedTargetingOption": {
    object (SelectedTargetingOption)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "impressions": string
  // End of mutually exclusive fields.
}
שדות
selectedTargetingOption

object (SelectedTargetingOption)

אפשרות הטירגוט או אפשרויות הטירגוט שנבחרו לסוג טירגוט אחד.
אפשר לכלול רק סוג אחד של נתוני פירוט. זו רשימה של שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
impressions

string (int64 format)

תחזית חשיפות.
סוף השדות שמוציאים זה את זה.

ErrorDetails

פרטי השגיאה שצוינו כשיש שגיאות בעדכון.

ייצוג ב-JSON 
{
  "message": string,
  "instantDealErrorStatus": enum (InstantDealErrorStatus)
}
שדות
message

string

ההודעה שמוצגת כשיש שגיאות בעדכון.
instantDealErrorStatus

enum (InstantDealErrorStatus)

סטטוס השגיאה שמופיע כשיש שגיאות בעדכון של העסקאות המיידיות.

InstantDealErrorStatus

סטטוס השגיאה שמוצג כשיש שגיאות בעדכון המיידי של העסקה.

טיפוסים בני מנייה (enum)
INSTANT_DEAL_ERROR_STATUS_UNSPECIFIED סטטוס שגיאה לא מזוהה.
INSTANT_DEAL_ERROR_STATUS_INVENTORY_UNAVAILABLE סטטוס השגיאה מציין שהמלאי לא זמין.
INSTANT_DEAL_ERROR_STATUS_FORECAST_UNAVAILABLE סטטוס השגיאה מציין שהתחזית לא זמינה.
INSTANT_DEAL_ERROR_STATUS_INVALID_INPUT סטטוס השגיאה מציין שיש שדות להזנת קלט לא תקינים.

FrequencyCap

מספר הפעמים שבהן משתמש יכול לראות את אותה מודעה במהלך תקופה נתונה

ייצוג ב-JSON 
{
  "timeUnit": enum (TimeUnit),
  "maxImpressions": string
}
שדות
timeUnit

enum (TimeUnit)

יחידת הזמן שבה תוחל מכסת התדירות.
maxImpressions

string (int64 format)

מספר הפעמים המקסימלי שבו המודעה תוצג למשתמש במהלך התקופה הזו.

TimeUnit

יחידת הזמן שבה תוחל מכסת התדירות.

טיפוסים בני מנייה (enum)
TIME_UNIT_UNSPECIFIED לא צוינה יחידת זמן.
TIME_UNIT_LIFETIME מכסת התדירות תחול על כל משך החיים של הקמפיין.
TIME_UNIT_MONTHS מכסת התדירות תחול על מספר חודשים.
TIME_UNIT_WEEKS מכסת התדירות תוחל על מספר שבועות.
TIME_UNIT_DAYS מכסת התדירות תחול על מספר ימים.

Methods

create

 יצירת מוצר.

get

 קבלת מוצר.

list

 רשימת מוצרים.

patch

 עדכון מוצר.