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

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

object (CustomParameter)

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

string

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

string

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

string

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

string

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

AppStore

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

טיפוסים בני מנייה (enum)
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

רשימה של כתובות URL סופיות לנייד לאחר כל ההפניות האוטומטיות בדומיינים.
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

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

object (CustomParameter)

רשימת מיפויים שישמשו להחלפת תגים של פרמטרים מותאמים אישית של כתובות URL ב-trackingUrlTemplates, ב-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)

אחוז הנחה במבצע במיליוניות השנייה. מיליון שווה לאחוז אחד. יש לציין את הערך הזה או כסף_off_amount.
moneyAmountOff

object (Money)

סכום הנחה להנחה במבצע. חובה להגדיר את הפרמטר הזה או את הערך percentOff.
שדה איחוד 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

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