REST Resource: accounts.products

משאב: מוצר

המוצר המעובד, שנוצר מכמה product inputs אחרי החלת כללים ומקורות נתונים משלימים. המוצר המעובד הזה תואם למוצר שמוצג בחשבון Merchant Center שלכם, במודעות שופינג ובפלטפורמות אחרות של Google. כל מוצר נוצר מנתוני מוצר אחד בלבד ממקור הנתונים הראשי וממספר מקורות נתונים משלימים. אחרי שמוסיפים, מעדכנים או מוחקים קלט של מוצר, יכול להיות שיחלפו כמה דקות עד שאפשר יהיה לאחזר את המוצר המעובד המעודכן.

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

ייצוג ב-JSON 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
שדות
name

string

שם המוצר. פורמט: "{product.name=accounts/{account}/products/{product}}" כאשר הקטע האחרון product מורכב מ-4 חלקים: channel~contentLanguage~feedLabel~offerId. דוגמה לשם מוצר היא "accounts/123/products/online~iw~IL~sku123"
channel

enum (ChannelEnum)

פלט בלבד. הערוץ של המוצר.
offerId

string

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

string

פלט בלבד. קוד השפה בן שתי האותיות של המוצר לפי תקן ISO 639-1.
feedLabel

string

פלט בלבד. תווית הפיד של המוצר.
dataSource

string

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

object (Attributes)

פלט בלבד. רשימה של מאפייני מוצרים.
customAttributes[]

object (CustomAttribute)

פלט בלבד. רשימה של מאפיינים מותאמים אישית (שסופקו על ידי המוכר). אפשר גם להשתמש בו כדי לשלוח כל מאפיין של מפרט הנתונים בצורתו הגנרית (לדוגמה, { "name": "size type", "value": "regular" }). האפשרות הזו שימושית לשליחת מאפיינים שלא נחשפים באופן מפורש על ידי ה-API, כמו מאפיינים נוספים המשמשים את 'קונים ב-Google'.
productStatus

object (ProductStatus)

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

string (int64 format)

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

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

התכונה נתמכת רק להוספה למקורות נתונים ראשיים.

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

ProductStatus

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

ייצוג ב-JSON 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
שדות
destinationStatuses[]

object (DestinationStatus)

היעדים המיועדים למוצר.
itemLevelIssues[]

object (ItemLevelIssue)

רשימה של כל הבעיות שמשויכות למוצר.
creationDate

string (Timestamp format)

התאריך שבו הפריט נוצר, בפורמט ISO 8601.
lastUpdateDate

string (Timestamp format)

התאריך שבו הפריט עודכן לאחרונה, בפורמט ISO 8601.
googleExpirationDate

string (Timestamp format)

התאריך שבו התוקף של הפריט יפוג, בפורמט ISO 8601.

DestinationStatus

סטטוס היעד של סטטוס המוצר.

ייצוג ב-JSON 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
שדות
reportingContext

enum (ReportingContextEnum)

השם של ההקשר של הדיווח.
approvedCountries[]

string

רשימת קודי המדינות (ISO 3166-1 alpha-2) שבהן המבצע מאושר.
pendingCountries[]

string

רשימת קודי המדינות (ISO 3166-1 alpha-2) שבהן המבצע בהמתנה לאישור.
disapprovedCountries[]

string

רשימה של קודי מדינות (ISO 3166-1 alpha-2) שבהן המבצע נדחה.

ItemLevelIssue

הבעיה ברמת הפריט בסטטוס המוצר.

ייצוג ב-JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
שדות
code

string

קוד השגיאה של הבעיה.
severity

enum (Severity)

איך הבעיה הזו משפיעה על הצגת המבצע.
resolution

string

אם המוכר יכול לפתור את הבעיה.
attribute

string

שם המאפיין, אם הבעיה נגרמת על ידי מאפיין יחיד.
reportingContext

enum (ReportingContextEnum)

ההקשר של הדיווח שאליו הבעיה רלוונטית.
description

string

תיאור קצר של הבעיה באנגלית.
detail

string

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

string

כתובת ה-URL של דף אינטרנט שיעזור לנו לפתור את הבעיה.
applicableCountries[]

string

רשימה של קודי מדינות (ISO 3166-1 alpha-2) שבהן הבעיה רלוונטית למבצע.

מידת החומרה

איך הבעיה משפיעה על הצגת המוצר.

טיפוסים בני מנייה (enum)
SEVERITY_UNSPECIFIED לא צוין.
NOT_IMPACTED הבעיה הזו היא אזהרה ואין לה השפעה ישירה על המוצר.
DEMOTED המוצר יורד לסטטוס נמוך יותר, וסביר להניח שהביצועים שלו בתוצאות החיפוש יהיו מוגבלים
DISAPPROVED הבעיה גורמת לפסילה של המוצר.

Methods

get

 אחזור המוצר המעובד מחשבון Merchant Center.

list

 רשימה של המוצרים שעברו עיבוד בחשבון Merchant Center.