REST Resource: advertisers.lineItems

משאב: פריט שורה

פריט יחיד.

ייצוג JSON 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "inventorySourceIds": [
    string
  ],
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean
}
שדות
name

string

פלט בלבד. שם המשאב של הפריט.
advertiserId

string (int64 format)

פלט בלבד. המזהה הייחודי של המפרסם שאליו שייך הפריט.
campaignId

string (int64 format)

פלט בלבד. המזהה הייחודי של הקמפיין שהפריט שייך לו.
insertionOrderId

string (int64 format)

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

string (int64 format)

פלט בלבד. המזהה הייחודי של הפריט. הוקצה על ידי המערכת.
displayName

string

חובה. השם המוצג של הפריט.

חייב להיות בקידוד UTF-8 ובגודל מקסימלי של 240 בייטים.
lineItemType

enum (LineItemType)

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

enum (EntityStatus)

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

  • עבור שיטת lineItems.create, מותר להשתמש רק ב-ENTITY_STATUS_DRAFT. כדי להפעיל פריט, יש להשתמש בשיטת lineItems.patch ולעדכן את הסטטוס ל-ENTITY_STATUS_ACTIVE לאחר היצירה.
  • אי אפשר לשנות סטטוס של פריט בחזרה לסטטוס ENTITY_STATUS_DRAFT מכל סטטוס אחר.
  • אם הזמנת ההורה של הפריט אינה פעילה, הפריט לא יכול למצות את התקציב שלו גם אם הסטטוס שלו הוא ENTITY_STATUS_ACTIVE.
updateTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של העדכון האחרון של הפריט. הוקצה על ידי המערכת.

חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
partnerCosts[]

object (PartnerCost)

עלויות השותף שמשויכות לפריט.

אם המאפיין חסר או ריק בשיטה lineItems.create, הפריט החדש שייווצר יירש את עלויות השותף מהזמנת ההורה שלו.
flight

object (LineItemFlight)

חובה. זמן ההתחלה ושעת הסיום של הטיסה של הפריט.
budget

object (LineItemBudget)

חובה. הגדרת הקצאת התקציב של הפריט.
pacing

object (Pacing)

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

object (FrequencyCap)

חובה. ההגדרות של מכסת תדירות החשיפות של הפריט.

אם מקצים מכסה מוגבלת, צריך להשתמש בשדה maxImpressions באובייקט ההגדרות הזה.
partnerRevenueModel

object (PartnerRevenueModel)

חובה. הגדרת מודל הכנסות השותף עבור הפריט.
conversionCounting

object (ConversionCountingConfig)

הגדרת מעקב ההמרות של הפריט.
creativeIds[]

string (int64 format)

המזהים של נכסי הקריאייטיב שמשויכים לפריט.
bidStrategy

object (BiddingStrategy)

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

object (IntegrationDetails)

פרטי השילוב של הפריט.
inventorySourceIds[]

string (int64 format)

המזהים של המקורות של מלאי שטחי הפרסום הפרטי שהוקצו לפריט.
targetingExpansion

object (TargetingExpansionConfig)

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

ההגדרה הזו רלוונטית רק לפריטים לרשת המדיה, לפריטי וידאו או לאודיו שמוגדר בהם בידינג אוטומטי ומטרגטים באופן חיובי רשימות קהלים שעומדות בדרישות.
warningMessages[]

enum (LineItemWarningMessage)

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

object (MobileApp)

האפליקציה לנייד שהפריט מקדם.

רלוונטי רק כאשר הערך של lineItemType הוא LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL או LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.
reservationType

enum (ReservationType)

פלט בלבד. סוג ההזמנה של הפריט.
excludeNewExchanges

boolean

האם להחריג בורסות חדשות מטירגוט אוטומטי על ידי הפריט. השדה הזה מוגדר כ-False כברירת מחדל.

LineItemType

סוגים אפשריים של פריט.

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

טיפוסים בני מנייה (enums)
LINE_ITEM_TYPE_UNSPECIFIED

ערך הסוג לא צוין או שהוא לא ידוע בגרסה הזו.

לא ניתן ליצור או לעדכן פריטים מהסוג הזה באמצעות ה-API.
LINE_ITEM_TYPE_DISPLAY_DEFAULT מודעות תמונה, HTML5, מודעות מותאמות או מודעות מדיה עשירה.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL מודעות ברשת המדיה שמעודדות התקנות של אפליקציה.
LINE_ITEM_TYPE_VIDEO_DEFAULT מודעות וידאו שנמכרות על בסיס עלות לאלף חשיפות במגוון סביבות.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL מודעות וידאו שמעודדות התקנות של אפליקציה.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

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

לא ניתן ליצור או לעדכן פריטים מהסוג הזה באמצעות ה-API.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY

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

לא ניתן ליצור או לעדכן פריטים מהסוג הזה באמצעות ה-API.
LINE_ITEM_TYPE_AUDIO_DEFAULT מודעות אודיו של RTB שנמכרות במגוון סביבות.
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP מודעות ישירות ללקוח (OTT). הסוג הזה רלוונטי רק לפריטים עם הזמנת קמפיין של insertionOrderType OVER_THE_TOP.

LineItemFlight

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

ייצוג JSON 
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  },
  "triggerId": string
}
שדות
flightDateType

enum (LineItemFlightDateType)

חובה. הסוג של תאריכי הטיסה של הפריט.
dateRange

object (DateRange)

תאריכי ההתחלה והסיום של הטיסה בפריט. הם מזוהים בהתאם לאזור הזמן של מפרסם ההורה.

  • חובה כאשר flightDateType הוא LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM. במקרים אחרים, צריך לייצא פלט בלבד.
  • כשיוצרים טיסה חדשה, גם startDate וגם endDate חייבים להיות בעתיד.
  • לטיסה קיימת עם startDate בעבר יש endDate שניתן לשנות, אבל startDate שלא ניתן לשינוי.
  • endDate חייב להיות startDate או תאריך מאוחר יותר, שניהם לפני שנת 2037.
triggerId

string (int64 format)

המזהה של הטריגר הידני שמשויך לפריט.

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

אזהרה: פריטים שנעשה בהם שימוש בטריגרים ידניים לא יוצגו יותר ב-Display & Video 360. השדה הזה ייסגר ב-1 באוגוסט 2023. מידע נוסף זמין בהודעה על הוצאה משימוש של התכונות.

LineItemFlightDateType

סוגים אפשריים של תאריכי טיסה של פריט.

טיפוסים בני מנייה (enums)
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED ערך הסוג לא צוין או שהוא לא ידוע בגרסה הזו.
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED תאריכי פרק הזמן של הפרסום של הפריט עוברים בירושה מהזמנת האם של הפריט.
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM לפריט הזה יש תאריכי פרסום מותאמים אישית משלו.
LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

הפריט משתמש בטריגר.

אזהרה: פריטים שנעשה בהם שימוש בטריגרים ידניים לא יוצגו יותר ב-Display & Video 360. הערך הזה ייסגר ב-1 באוגוסט 2023. מידע נוסף זמין בהודעה על הוצאה משימוש של התכונות.

LineItemBudget

הגדרות שקובעות את אופן הקצאת התקציב.

ייצוג JSON 
{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
שדות
budgetAllocationType

enum (LineItemBudgetAllocationType)

חובה. הסוג של הקצאת התקציב.

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC רלוונטי רק כאשר הקצאת תקציב אוטומטית מופעלת לסדר ההכנסה הראשי.
budgetUnit

enum (BudgetUnit)

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

string (int64 format)

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

כשהערך בשדה budgetAllocationType הוא:

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC, השדה הזה לא ניתן לשינוי והוא מוגדר על ידי המערכת.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED, אם הערך של budgetUnit הוא:
    • BUDGET_UNIT_CURRENCY, השדה הזה מייצג את סכום התקציב המקסימלי להוצאה, במיליוניות השנייה של המטבע של המפרסם. לדוגמה, 1500000 מייצג 1.5 יחידות סטנדרטיות של המטבע.
    • BUDGET_UNIT_IMPRESSIONS, השדה הזה מייצג את המספר המקסימלי של חשיפות שאפשר להציג.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, השדה הזה לא רלוונטי והמערכת תתעלם ממנו.

LineItemBudgetAllocationType

סוגים אפשריים של הקצאת התקציב

טיפוסים בני מנייה (enums)
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED ערך הסוג לא צוין או שהוא לא ידוע בגרסה הזו.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC הקצאת תקציב אוטומטית מופעלת עבור הפריט.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED סכום קבוע של תקציב מקסימלי מוקצה לפריט.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED לא חלה מגבלת תקציב על הפריט.

PartnerRevenueModel

הגדרות שקובעות איך מחושבות הכנסות השותף.

ייצוג JSON 
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
שדות
markupType

enum (PartnerRevenueModelMarkupType)

חובה. סוג תגי העיצוב של מודל הכנסות השותף.
markupAmount

string (int64 format)

חובה. סכום תגי העיצוב של מודל הכנסות השותף. חייב להיות גדול מ-0 או שווה לו.

  • כשהערך בשדה markupType הוא PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM, השדה הזה מייצג את תגי העיצוב של העלות לאלף חשיפות במיליוניות השנייה של המטבע של המפרסם. לדוגמה, 1500000 מייצג 1.5 יחידות סטנדרטיות של המטבע.
  • כשהערך בשדה markupType הוא PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP, השדה הזה מייצג את תגי העיצוב של אחוז עלות המדיה באלפיות השנייה. לדוגמה, 100 מייצג 0.1% (0.001 עשרוני).
  • כשהערך בשדה markupType מוגדר לערך PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP, השדה הזה מייצג את הסימון באחוזים של עלות המדיה הכוללת באלפיות השנייה. לדוגמה, 100 מייצג 0.1% (0.001 עשרוני).

PartnerRevenueModelMarkupType

סוגי תגי עיצוב אפשריים במודל הכנסות השותף.

טיפוסים בני מנייה (enums)
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED ערך הסוג לא צוין או שהוא לא ידוע בגרסה הזו.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM מחשבים את הכנסות השותף על סמך עלות קבועה לאלף חשיפות.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

מחשבים את הכנסות השותף על סמך אחוז התשלום הנוסף מתוך עלות המדיה.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP מחשבים את הכנסות השותף על סמך אחוז התשלום הנוסף מתוך עלות המדיה הכוללת, שכולל את כל עלויות השותפים ועלויות הנתונים.

ConversionCountingConfig

הגדרות שקובעות איך המרות נספרות.

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

ייצוג JSON 
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}
שדות
postViewCountPercentageMillis

string (int64 format)

אחוז ההמרות לאחר צפייה שצריך לספור, באלפיות השנייה (1/1,000 של אחוז). חייב להיות בין 0 ל-100,000, כולל.

לדוגמה, כדי לעקוב אחר 50% מההמרות שהתרחשו לאחר קליק, מגדירים את הערך 50,000.
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

הגדרות הפעילות ב-Floodlight שמשמשות למעקב אחר המרות.

מספר ההמרות שנספרו הוא הסכום של כל ההמרות שנספרו לפי כל מזהי הפעילות ב-Floodlight שצוינו בשדה הזה.

TrackingFloodlightActivityConfig

הגדרות שקובעות את ההתנהגות של תצורה יחידה של פעילות ב-Floodlight.

ייצוג JSON 
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
שדות
floodlightActivityId

string (int64 format)

חובה. המזהה של הפעילות ב-Floodlight.
postClickLookbackWindowDays

integer

חובה. מספר הימים לאחר קליק על מודעה שבהם ניתן לספור המרה. חייב להיות בין 0 ל-90, כולל.
postViewLookbackWindowDays

integer

חובה. מספר הימים לאחר צפייה במודעה שבהם ניתן לספור המרה. חייב להיות בין 0 ל-90, כולל.

TargetingExpansionConfig

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

ייצוג JSON 
{
  "targetingExpansionLevel": enum (TargetingExpansionLevel),
  "excludeFirstPartyAudience": boolean
}
שדות
targetingExpansionLevel

enum (TargetingExpansionLevel)

חובה. האם התכונה 'אופטימיזציית טירגוט' מופעלת.

שדה זה תומך בערכים הבאים:

  • NO_EXPANSION: אופטימיזציית הטירגוט מושבתת
  • LEAST_EXPANSION: אופטימיזציית הטירגוט מופעלת

אם בשדה הזה מוגדר ערך אחר, הוא יוגדר אוטומטית כ-LEAST_EXPANSION.

הערך NO_EXPANSION יהיה ערך ברירת המחדל של השדה, ויוקצה באופן אוטומטי אם לא יוגדר בשדה הזה.
excludeFirstPartyAudience
(deprecated)

boolean

האם להחריג קהלים מאינטראקציה ישירה משימוש בהרחבת הטירגוט.

השדה הזה הוצא משימוש כשהשקנו את התכונה אופטימיזציית טירגוט.

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

TargetingExpansionLevel

ההגדרה 'אופטימיזציית טירגוט'.

טיפוסים בני מנייה (enums)
TARGETING_EXPANSION_LEVEL_UNSPECIFIED ההגדרה של אופטימיזציית הטירגוט לא צוינה בגרסה הזו או שהיא לא ידועה.
NO_EXPANSION אופטימיזציית הטירגוט מושבתת.
LEAST_EXPANSION אופטימיזציית הטירגוט מופעלת.
SOME_EXPANSION

אם ייעשה שימוש, המדיניות תוגדר באופן אוטומטי ל-LEAST_EXPANSION.
BALANCED_EXPANSION

אם ייעשה שימוש, המדיניות תוגדר באופן אוטומטי ל-LEAST_EXPANSION.
MORE_EXPANSION

אם ייעשה שימוש, המדיניות תוגדר באופן אוטומטי ל-LEAST_EXPANSION.
MOST_EXPANSION

אם ייעשה שימוש, המדיניות תוגדר באופן אוטומטי ל-LEAST_EXPANSION.

LineItemWarningMessage

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

טיפוסים בני מנייה (enums)
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED לא צוין או לא ידוע.
INVALID_FLIGHT_DATES לפריט הזה הוגדרו תאריכים לא חוקיים של פרק זמן של פרסום פעיל. הפריט לא יפעל.
EXPIRED תאריך הסיום של הפריט הזה חל בעבר.
PENDING_FLIGHT הפריט הזה יתחיל לפעול בעתיד.
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED כל הערוצים המופעלים של שותפים נכללים במיקוד שלילי. הפריט לא יפעל.
INVALID_INVENTORY_SOURCE אין מיקוד למקורות פעילים של מלאי שטחי פרסום. הפריט לא יפעל.
APP_INVENTORY_INVALID_SITE_TARGETING המיקוד לאפליקציות ולכתובות URL של הפריט הזה לא כולל אפליקציות לנייד. סוג הפריט הזה מחייב אותך לכלול אפליקציות לנייד בטירגוט של הערוץ, רשימת האתרים או האפליקציות. הפריט לא יפעל.
APP_INVENTORY_INVALID_AUDIENCE_LISTS הפריט הזה לא מטרגט משתמשים בנייד. לסוג הפריט הזה צריך לטרגט רשימת משתמשים עם משתמשים בנייד. הפריט לא יפעל.
NO_VALID_CREATIVE הפריט הזה לא מכיל קריאייטיב חוקי. הפריט לא יפעל.
PARENT_INSERTION_ORDER_PAUSED סדר ההכנסה של הפריט הזה נמצא בהשהיה. הפריט לא יפעל.
PARENT_INSERTION_ORDER_EXPIRED לסדר ההכנסה של הפריט הזה הוגדר תאריך סיום שכבר חלף. הפריט לא יפעל.
NO_POSITIVE_AUDIENCE_LIST_TARGETED הפריט הזה לא ממקד לרשימות קהלים, מה שעשוי להוביל לניצול מהיר מדי של התקציב.
APP_INSTALL_NO_CONVERSION_PIXEL לפריט הזה של התקנת אפליקציה עדיין לא הוגדר פיקסל המרה.
TARGETING_REVOKED_OR_CLOSED_USER_LIST הפריט הזה מטרגט רשימת משתמשים אחת או יותר שכבר לא זמינה. מצב כזה ימנע בעתיד את הצגת הפריט, לכן מומלץ להסיר את הרשימות האלה מהטירגוט.
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY לפריט הזה לעידוד התקנת אפליקציה לא הוגדרה שיטת בידינג אופטימלית
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS הפריט הזה ממקד לעסקאות שתומכות בגודלי קראייטיב שלא נמצאים בשימוש. מצב כזה עשוי להגביל את ההצגה או הביצועים של הפריט.
NO_CREATIVE_FOR_TARGETED_DEALS הפריט הזה לא מכיל קריאייטיב עבור העסקאות המטורגטות.
TARGETING_DEPRECATED_GEO_TARGET הפריט הזה מטרגט טירגוט גיאוגרפי שהוצא משימוש.
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

הפריט הזה משתמש בהגדרה excludeFirstPartyAudience, שהוצאה משימוש ותוכננה לצאת משימוש אחרי 25 במרץ 2023.

כדי להביא בחשבון את סגירת השדה excludeFirstPartyAudience, צריך לעדכן את שילוב ה-API כך שיוחרג באופן ישיר מקהלים מאינטראקציה ישירה שמשתמשים בטירגוט לפי קהל לפני 25 במרץ 2023.

MobileApp

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

ייצוג JSON 
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
שדות
appId

string

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

אפליקציות ל-Android מזוהות לפי מזהה החבילה שמשמש את חנות Play של Android, למשל com.google.android.gm.

אפליקציות ל-iOS מזוהות באמצעות מזהה אפליקציה בן תשע ספרות ש-App Store של Apple משתמש בו. למשל: 422689480.
platform

enum (Platform)

פלט בלבד. פלטפורמת האפליקציה.
displayName

string

פלט בלבד. שם האפליקציה.
publisher

string

פלט בלבד. הבעלים של האפליקציה.

הפלטפורמה

פלטפורמות אפשריות של אפליקציות לנייד.

טיפוסים בני מנייה (enums)
PLATFORM_UNSPECIFIED לא צוינה פלטפורמה.
IOS iOS.
ANDROID פלטפורמת Android.

שיטות

bulkEditLineItemAssignedTargetingOptions

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

bulkListLineItemAssignedTargetingOptions

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

create

 יצירת פריט חדש.

delete

 מוחק פריט.

generateDefault

 הפונקציה יוצרת פריט חדש עם ההגדרות (כולל טירגוט) שעברו בירושה מהזמנת הקמפיין וentity_statusENTITY_STATUS_DRAFT.

get

 מקבל פריט.

list

 בתיבת הדו-שיח הזו מוצגים פריטים של מפרסם.

patch

 עדכון פריט קיים.