ExtensionFeedItem

פריט בפיד של תוסף.

ייצוג JSON 
{
  "resourceName": string,
  "extensionType": enum (ExtensionType),
  "adSchedules": [
    {
      object (AdScheduleInfo)
    }
  ],
  "device": enum (FeedItemTargetDevice),
  "targetedKeyword": {
    object (KeywordInfo)
  },
  "status": enum (FeedItemStatus),
  "id": string,
  "startDateTime": string,
  "endDateTime": string,
  "targetedGeoTargetConstant": string,

  // Union field extension can be only one of the following:
  "sitelinkFeedItem": {
    object (SitelinkFeedItem)
  },
  "structuredSnippetFeedItem": {
    object (StructuredSnippetFeedItem)
  },
  "appFeedItem": {
    object (AppFeedItem)
  },
  "callFeedItem": {
    object (CallFeedItem)
  },
  "calloutFeedItem": {
    object (CalloutFeedItem)
  },
  "textMessageFeedItem": {
    object (TextMessageFeedItem)
  },
  "priceFeedItem": {
    object (PriceFeedItem)
  },
  "promotionFeedItem": {
    object (PromotionFeedItem)
  },
  "locationFeedItem": {
    object (LocationFeedItem)
  },
  "affiliateLocationFeedItem": {
    object (AffiliateLocationFeedItem)
  },
  "hotelCalloutFeedItem": {
    object (HotelCalloutFeedItem)
  },
  "imageFeedItem": {
    object (ImageFeedItem)
  }
  // End of list of possible types for union field extension.

  // Union field serving_resource_targeting can be only one of the following:
  "targetedCampaign": string,
  "targetedAdGroup": string
  // End of list of possible types for union field serving_resource_targeting.
}
שדות
resourceName

string

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

customers/{customerId}/extensionFeedItems/{feed_item_id}
extensionType

enum (ExtensionType)

פלט בלבד. סוג התוסף של פריט פיד התוסף. השדה הזה הוא לקריאה בלבד.
adSchedules[]

object (AdScheduleInfo)

רשימה של לוחות זמנים שאינם חופפים, שמציינת את כל מרווחי הזמן שעבורם הפריט בפיד עשוי להופיע. אפשר להשתמש ב-6 לוחות זמנים לכל היותר ביום.
device

enum (FeedItemTargetDevice)

המכשיר המטורגט.
targetedKeyword

object (KeywordInfo)

מילת המפתח המטורגטת.
status

enum (FeedItemStatus)

פלט בלבד. הסטטוס של הפריט בפיד. השדה הזה הוא לקריאה בלבד.
id

string (int64 format)

פלט בלבד. המזהה של פריט הפיד הזה. קריאה בלבד.
startDateTime

string

שעת ההתחלה שבה פריט הפיד הזה בתוקף ויכול להתחיל להופיע. השעה היא באזור הזמן של הלקוח. הפורמט הוא 'YYYY-MM-DD HH:MM:SS'. לדוגמה: 2018-03-05 09:15:00 או 2018-02-01 14:34:30
endDateTime

string

שעת הסיום שבה פריט הפיד הזה כבר לא בתוקף ויפסיק להופיע. השעה היא באזור הזמן של הלקוח. הפורמט הוא 'YYYY-MM-DD HH:MM:SS'. לדוגמה: 2018-03-05 09:15:00 או 2018-02-01 14:34:30
targetedGeoTargetConstant

string

קבוע המיקוד הגיאוגרפי המטורגט.
שדה איחוד extension. סוג תוסף. extension יכול להיות רק אחד מהבאים:
structuredSnippetFeedItem

object (StructuredSnippetFeedItem)

תוסף מידע מובנה.
appFeedItem

object (AppFeedItem)

תוסף אפליקציה.
callFeedItem

object (CallFeedItem)

תוסף שיחה.
calloutFeedItem

object (CalloutFeedItem)

תוסף יתרונות מרכזיים.
textMessageFeedItem

object (TextMessageFeedItem)

תוסף לשליחת SMS.
priceFeedItem

object (PriceFeedItem)

תוסף מחיר.
promotionFeedItem

object (PromotionFeedItem)

תוסף קידום מכירות.
locationFeedItem

object (LocationFeedItem)

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

object (AffiliateLocationFeedItem)

פלט בלבד. תוסף מיקומים מקושרים. מיקומי הפיד מאוכלסים על ידי Google Ads לפי מזהה רשת. השדה הזה הוא לקריאה בלבד.
hotelCalloutFeedItem

object (HotelCalloutFeedItem)

תוסף יתרונות מרכזיים של מלון.
imageFeedItem

object (ImageFeedItem)

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

string

הקמפיין המטורגט.
targetedAdGroup

string

קבוצת המודעות המטורגטת.

StructuredSnippetFeedItem

מייצג תוסף מידע מובנה.

ייצוג JSON 
{
  "values": [
    string
  ],
  "header": string
}
שדות
values[]

string

הערכים בקטע הקוד. הגודל המקסימלי של האוסף הזה הוא 10.
header

string

הכותרת של קטע הטקסט. המחרוזת הזו לא יכולה להיות ריקה.

AppFeedItem

מייצג תוסף לאפליקציה.

ייצוג JSON 
{
  "appStore": enum (AppStore),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "linkText": string,
  "appId": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string
}
שדות
appStore

enum (AppStore)

חנות האפליקציות שאליה שייכת אפליקציית היעד. חובה לבחור אפשרות לשדה הזה.
finalUrls[]

string

רשימה של כתובות URL סופיות אפשריות לאחר כל ההפניות האוטומטיות בדומיינים שונים. הרשימה לא יכולה להיות ריקה.
finalMobileUrls[]

string

רשימה של כתובות דף סופיות בנייד אפשריות לאחר כל ההפניות האוטומטיות בדומיינים שונים.
urlCustomParameters[]

object (CustomParameter)

רשימת מיפויים שישמשו להחלפת תגים של פרמטרים מותאמים אישית של כתובות URL ב-TrackingUrlTemplate, ב-FinalUrls וב-FinalMobileUrls.
linkText

string

הטקסט הגלוי שמוצג בזמן עיבוד הקישור במודעה. המחרוזת לא יכולה להיות ריקה, והאורך של המחרוזת הזו צריך להיות בין 1 ל-25, כולל.
appId

string

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

string

תבנית של כתובת URL ליצירת כתובת URL למעקב. ערך ברירת המחדל הוא "{lpurl}".
finalUrlSuffix

string

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

AppStore

סוג חנות האפליקציות בתוסף אפליקציה.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
APPLE_ITUNES Apple iTunes.
GOOGLE_PLAY Google Play.

TextMessageFeedItem

תוסף שהמשתמשים יכולים ללחוץ עליו כדי לשלוח הודעת טקסט למפרסם.

ייצוג JSON 
{
  "businessName": string,
  "countryCode": string,
  "phoneNumber": string,
  "text": string,
  "extensionText": string
}
שדות
businessName

string

שם העסק שיתווסף לפני הטקסט של ההודעה. חובה לבחור אפשרות לשדה הזה.
countryCode

string

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

string

מספר הטלפון של המפרסם שאליו תישלח ההודעה. חובה.
text

string

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

string

תוסף לשליחת SMS מאוכלס באפליקציה להעברת הודעות.

PriceFeedItem

מייצג תוסף מחיר.

ייצוג JSON 
{
  "type": enum (PriceExtensionType),
  "priceQualifier": enum (PriceExtensionPriceQualifier),
  "priceOfferings": [
    {
      object (PriceOffer)
    }
  ],
  "trackingUrlTemplate": string,
  "languageCode": string,
  "finalUrlSuffix": string
}
שדות
type

enum (PriceExtensionType)

סוג תוסף המחיר בתוסף הזה.
priceQualifier

enum (PriceExtensionPriceQualifier)

ערך אישור מחיר לכל המבצעים של תוסף המחיר הזה.
priceOfferings[]

object (PriceOffer)

הצעות המחיר בתוסף המחיר הזה.
trackingUrlTemplate

string

תבנית כתובת URL למעקב לכל המוצרים של תוסף המחיר הזה.
languageCode

string

קוד השפה שבו נעשה שימוש בתוסף המחיר הזה.
finalUrlSuffix

string

תבנית כתובת URL למעקב לכל המוצרים של תוסף המחיר הזה.

PriceOffer

מייצג מחיר אחד בתוסף מחיר.

ייצוג JSON 
{
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "header": string,
  "description": string
}
שדות
price

object (Money)

ערך המחיר של המבצע.
unit

enum (PriceExtensionPriceUnit)

יחידת המחיר של המבצע הזה.
finalUrls[]

string

רשימה של כתובות URL סופיות אפשריות לאחר כל ההפניות האוטומטיות בדומיינים שונים.
finalMobileUrls[]

string

רשימה של כתובות דף סופיות בנייד אפשריות לאחר כל ההפניות האוטומטיות בדומיינים שונים.
header

string

טקסט הכותרת של המבצע.
description

string

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

PromotionFeedItem

מייצג תוסף קידום מכירות.

ייצוג JSON 
{
  "discountModifier": enum (PromotionExtensionDiscountModifier),
  "occasion": enum (PromotionExtensionOccasion),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "promotionTarget": string,
  "promotionStartDate": string,
  "promotionEndDate": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "languageCode": string,

  // Union field discount_type can be only one of the following:
  "percentOff": string,
  "moneyAmountOff": {
    object (Money)
  }
  // End of list of possible types for union field discount_type.

  // Union field promotion_trigger can be only one of the following:
  "promotionCode": string,
  "ordersOverAmount": {
    object (Money)
  }
  // End of list of possible types for union field promotion_trigger.
}
שדות
discountModifier

enum (PromotionExtensionDiscountModifier)

מספר הערכים המשנים את התאמת ההנחה.
occasion

enum (PromotionExtensionOccasion)

האירוע שעבורו המבצע היה מיועד. אם הוגדר אירוע, חלון המימוש צריך להיות בטווח התאריכים המשויך לאירוע.
finalUrls[]

string

רשימה של כתובות URL סופיות אפשריות לאחר כל ההפניות האוטומטיות בדומיינים שונים. חובה לבחור אפשרות לשדה הזה.
finalMobileUrls[]

string

רשימה של כתובות דף סופיות בנייד אפשריות לאחר כל ההפניות האוטומטיות בדומיינים שונים.
urlCustomParameters[]

object (CustomParameter)

רשימת מיפויים שישמשו להחלפת תגים של פרמטרים מותאמים אישית של כתובות URL ב-TrackingUrlTemplate, ב-FinalUrls וב-FinalMobileUrls.
promotionTarget

string

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

string

תאריך ההתחלה שבו ניתן לממש את המבצע.
promotionEndDate

string

התאריך האחרון שבו ניתן לממש את המבצע.
trackingUrlTemplate

string

תבנית של כתובת URL ליצירת כתובת URL למעקב.
finalUrlSuffix

string

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

string

השפה של המבצע. מיוצג כתג שפה BCP 47.
שדה איחוד discount_type. סוג הנחה, יכול להיות הנחה באחוזים או הנחה באחוזים. discount_type יכול להיות רק אחד מהבאים:
percentOff

string (int64 format)

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

object (Money)

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

string

קוד שהמשתמש צריך להשתמש בו כדי להיות זכאי לקידום.
ordersOverAmount

object (Money)

הסכום הכולל של ההזמנה צריך להיות כדי שהמשתמש יהיה זכאי לקידום המכירות.

LocationFeedItem

מייצג תוסף מיקום.

ייצוג JSON 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string
}
שדות
businessName

string

שם העסק.
addressLine1

string

שורה 1 בכתובת העסק.
addressLine2

string

שורה 2 בכתובת העסק.
city

string

העיר של כתובת העסק.
province

string

המחוז של כתובת העסק.
postalCode

string

המיקוד של כתובת העסק.
countryCode

string

קוד המדינה של כתובת העסק.
phoneNumber

string

מספר הטלפון של העסק.

AffiliateLocationFeedItem

מייצג תוסף לחיפוש מפיצים.

ייצוג JSON 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string,
  "chainId": string,
  "chainName": string
}
שדות
businessName

string

שם העסק.
addressLine1

string

שורה 1 בכתובת העסק.
addressLine2

string

שורה 2 בכתובת העסק.
city

string

העיר של כתובת העסק.
province

string

המחוז של כתובת העסק.
postalCode

string

המיקוד של כתובת העסק.
countryCode

string

קוד המדינה של כתובת העסק.
phoneNumber

string

מספר הטלפון של העסק.
chainId

string (int64 format)

המזהה של הרשת הקמעונאית שמפורסמת כמפיץ של המוצר.
chainName

string

שם הרשת.

HotelCalloutFeedItem

מייצג תוסף יתרונות מרכזיים של מלון.

ייצוג JSON 
{
  "text": string,
  "languageCode": string
}
שדות
text

string

טקסט היתרונות המרכזיים. המחרוזת הזו צריכה להיות בין 1 ל-25, כולל.
languageCode

string

השפה שבה כתוב הטקסט של היתרונות המרכזיים של המלון. קוד שפה התואם ל-IETF BCP 47.

ImageFeedItem

מייצג תוסף תמונות שסופק על ידי מפרסם.

ייצוג JSON 
{
  "imageAsset": string
}
שדות
imageAsset

string

חובה. שם המשאב של נכס התמונות.