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

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

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

רשימה של כתובות 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)

Enum שמשנה את התאמת ההנחה.
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)

אחוז ההנחה במבצע ב-Micros. מיליון שווה ערך לאחוז אחד. צריך לציין את הערך הזה או את הערך currency_off_amount.
moneyAmountOff

object (Money)

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

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