Attributes

مشخصه‌های محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116 مراجعه کنید.

نمایش JSON
{
  "gtin": [
    string
  ],
  "mpn": string,
  "title": string,
  "brand": string,
  "productName": string,
  "productLine": string,
  "productType": [
    string
  ],
  "description": string,
  "featureDescription": [
    {
      object (FeatureDescription)
    }
  ],
  "imageLink": {
    object (Image)
  },
  "additionalImageLink": [
    {
      object (Image)
    }
  ],
  "videoLink": [
    string
  ],
  "productPageUrl": string,
  "disclosureDate": string,
  "releaseDate": string,
  "suggestedRetailPrice": {
    object (Price)
  },
  "productDetail": [
    {
      object (ProductDetail)
    }
  ],
  "itemGroupId": string,
  "scent": string,
  "flavor": string,
  "format": string,
  "capacity": {
    object (Capacity)
  },
  "gender": string,
  "ageGroup": string,
  "size": string,
  "sizeType": [
    string
  ],
  "sizeSystem": string,
  "color": string,
  "theme": string,
  "pattern": string,
  "material": string,
  "count": {
    object (Count)
  },
  "targetClientId": string,
  "excludedDestination": [
    string
  ],
  "includedDestination": [
    string
  ],
  "productHighlight": [
    string
  ],
  "richProductContent": [
    string
  ],
  "nutrition": {
    object (Nutrition)
  },
  "grocery": {
    object (Grocery)
  },
  "virtualModelLink": string,
  "certification": [
    {
      object (Certification)
    }
  ],
  "intendedCountry": [
    string
  ],
  "questionAndAnswer": [
    {
      object (QuestionAndAnswer)
    }
  ],
  "itemGroupTitle": string,
  "documentLink": [
    string
  ],
  "variantOption": [
    {
      object (VariantOption)
    }
  ],
  "relatedProduct": [
    {
      object (RelatedProduct)
    }
  ],
  "popularityRank": number
}
فیلدها
gtin[]

string

«شماره جهانی کالای تجاری» (GTIN) محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#gtin مراجعه کنید.

mpn

string

«شماره قطعه سازنده» (MPN) محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#mpn مراجعه کنید.

title

string

عنوان محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#title مراجعه کنید.

brand

string

نام نمانام محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#brand مراجعه کنید.

productName

string

نام متعارف محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#productname مراجعه کنید.

productLine

string

نام گروه محصولات مرتبط با محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#productline مراجعه کنید.

productType[]

string

نوع یا دسته محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#producttype مراجعه کنید.

description

string

شرح محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#description مراجعه کنید.

featureDescription[]

object (FeatureDescription)

شرح قالب غنی محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#featuredesc مراجعه کنید.

productPageUrl

string

نشانی وب صفحه جزئیات محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#productpage مراجعه کنید.

disclosureDate

string

تاریخ شفاف‌سازی محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#disclosure مراجعه کنید.

releaseDate

string

تاریخ انتشار محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#release مراجعه کنید.

suggestedRetailPrice

object (Price)

قیمت خرده‌فروشی پیشنهادی سازنده (MSRP) برای محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#price مراجعه کنید.

productDetail[]

object (ProductDetail)

جزئیات محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#productdetail مراجعه کنید.

itemGroupId

string

شناسه گروه مورد محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#itemgroupid مراجعه کنید.

scent

string

رایحه محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#scent مراجعه کنید.

flavor

string

طعم محصول. برای اطلاعات بیشتر، https://support.google.com/manufacturers/answer/6124116#flavor را ببینید.

format

string

قالب محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#format مراجعه کنید.

capacity

object (Capacity)

ظرفیت محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#capacity مراجعه کنید.

gender

string

جنسیت هدف محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#gender مراجعه کنید.

ageGroup

string

گروه سنی هدف محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#agegroup مراجعه کنید.

size

string

اندازه محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#size مراجعه کنید.

sizeType[]

string

نوع اندازه محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#sizetype مراجعه کنید.

sizeSystem

string

سیستم اندازه محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#sizesystem مراجعه کنید.

color

string

رنگ محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#color مراجعه کنید.

theme

string

طرح زمینه محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#theme مراجعه کنید.

pattern

string

الگوی محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#pattern مراجعه کنید.

material

string

جنس محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#material مراجعه کنید.

count

object (Count)

تعداد محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#count مراجعه کنید.

targetClientId

string

شناسه مشتری هدف. فقط باید در حساب‌های شرکای داده استفاده شود. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/10857344 مراجعه کنید

excludedDestination[]

string

فهرستی از مقصدهای مستثنی‌شده مانند «ClientExport»،‏ «ClientShoppingCatalog»، یا «PartnerShoppingCatalog». برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/7443550 مراجعه کنید

includedDestination[]

string

فهرستی از مقصدهای گنجانده‌شده مانند «ClientExport»،‏ «ClientShoppingCatalog»، یا «PartnerShoppingCatalog». برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/7443550 مراجعه کنید

productHighlight[]

string

ویژگی‌های اصلی محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/10066942 مراجعه کنید

richProductContent[]

string

محتوای غنی محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/9389865 مراجعه کنید

nutrition

object (Nutrition)

مشخصه‌های تغذیه. در https://support.google.com/manufacturers/answer/12098458#food-servings بیشتر ببینید.

grocery

object (Grocery)

مشخصه‌های خواربار. در https://support.google.com/manufacturers/answer/12098458#grocery بیشتر ببینید.

certification[]

object (Certification)

اختیاری. فهرست گواهینامه‌هایی که این محصول ادعا می‌کند دارد.

intendedCountry[]

string

اختیاری. فهرست کشورهایی که این محصول در آن‌ها نشان داده می‌شود. کشورهای ارائه‌شده در این مشخصه، جایگزین هریک از کشورهای پیکربندی‌شده در سطح فید خواهند شد. مقادیر باید این‌گونه باشند: کد قلمرو CLDR کشورهایی که این مورد در آن‌ها نشان داده خواهد شد.

questionAndAnswer[]

object (QuestionAndAnswer)

اختیاری. پرسشگان و پاسخ‌های مربوط به محصول.

itemGroupTitle

string

اختیاری. عنوان مشترک گروه محصولی که این گونه به آن تعلق دارد.

variantOption[]

object (VariantOption)

اختیاری. فهرست همه گزینه‌های شناسایی متغیر برای محصول.

relatedProduct[]

object (RelatedProduct)

اختیاری. محصولات مرتبط با این محصول، مانند لوازم جانبی یا جایگزین‌ها.

popularityRank

number

اختیاری. رتبه محبوبیت محصول از ۰٫۰ (پایین‌ترین) تا ۱۰۰٫۰ (بالاترین).

FeatureDescription

شرح ویژگی محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#featuredesc مراجعه کنید.

نمایش JSON
{
  "headline": string,
  "text": string,
  "image": {
    object (Image)
  }
}
فیلدها
headline

string

شرح کوتاهی از ویژگی.

text

string

شرح مفصلی از ویژگی.

image

object (Image)

تصویری اختیاری که ویژگی را توصیف می‌کند.

تصویر

تصویر.

نمایش JSON
{
  "type": enum (Type),
  "status": enum (Status),
  "imageUrl": string
}
فیلدها
type

enum (Type)

نوع تصویر، یعنی خزیده یا بارگذاری‌شده.

توجه: این فیلد فقط در پاسخ‌ها استفاده می‌شود. هر مقداری که در اینجا در درخواست مشخص شده باشد نادیده گرفته می‌شود.

status

enum (Status)

وضعیت تصویر.

توجه: این فیلد فقط در پاسخ‌ها استفاده می‌شود. هر مقداری که در اینجا در درخواست مشخص شده باشد نادیده گرفته می‌شود.

imageUrl

string

نشانی وب تصویر. برای تصاویر خزیده، این نشانی وب ارائه‌شده است. برای تصاویر بارگذاری‌شده، اگر تصویر با موفقیت پردازش شده باشد، این نشانی وب ارائه‌دهنده از Google است.

نوع

نوع تصویر، یعنی خزیده یا بارگذاری‌شده.

شمارشی‌ها
TYPE_UNSPECIFIED نوع مشخص نشده است. نباید استفاده شود.
CRAWLED تصویر از نشانی وب ارائه‌شده خزیده شده است.
UPLOADED تصویر بارگذاری شد.

وضعیت

وضعیت تصویر.

شمارشی‌ها
STATUS_UNSPECIFIED وضعیت تصویر نامشخص است. نباید استفاده شود.
PENDING_PROCESSING تصویر بارگذاری شد و درحال پردازش است.
PENDING_CRAWL خزیدن تصویر هنوز درحال انتظار است.
OK تصویر پردازش شد و الزامات را برآورده می‌کند.
ROBOTED نشانی وب تصویر با فایل robots.txt محافظت می‌شود و نمی‌تواند خزیده شود.
XROBOTED نشانی وب تصویر با X-Robots-Tag محافظت می‌شود و نمی‌تواند خزیده شود.
CRAWL_ERROR هنگام خزیدن تصویر خطایی روی داد.
PROCESSING_ERROR تصویر پردازش نمی‌شود.
DECODING_ERROR تصویر رمزگشایی نمی‌شود.
TOO_BIG تصویر خیلی بزرگ است.
CRAWL_SKIPPED تصویر به‌طور دستی لغو شده است و خزیده نخواهد شد.
HOSTLOADED خزیدن تصویر برای جلوگیری از بارگذاری بیش‌ازحد میزبان به تعویق افتاد.
HTTP_404 نشانی وب تصویر خطای «۴۰۴ پیدا نشد» را برگرداند.

قیمت

یک قیمت.

نمایش JSON
{
  "amount": string,
  "currency": string
}
فیلدها
amount

string

مقدار عددی قیمت.

currency

string

واحد پولی که قیمت با آن نشان داده می‌شود.

ProductDetail

جزئیات محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#productdetail مراجعه کنید.

نمایش JSON
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
فیلدها
sectionName

string

نام کوتاه بخش که می‌تواند بین جزئیات چند محصول مجدداً استفاده شود.

attributeName

string

نام مشخصه.

attributeValue

string

مقدار مشخصه.

ظرفیت

ظرفیت محصول. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#capacity مراجعه کنید.

نمایش JSON
{
  "value": string,
  "unit": string
}
فیلدها
value

string (int64 format)

مقدار عددی ظرفیت.

unit

string

واحد ظرفیت، یعنی مگابایت، گیگابایت، یا ترابایت.

شمارش

تعداد محصولات در یک بسته. برای اطلاعات بیشتر، به https://support.google.com/manufacturers/answer/6124116#count مراجعه کنید.

نمایش JSON
{
  "value": string,
  "unit": string
}
فیلدها
value

string (int64 format)

مقدار عددی تعداد محصولات در بسته.

unit

string

واحدی که این محصولات در آن شمارش می‌شوند.

تغذیه

نمایش JSON
{
  "servingSizeDescription": string,
  "servingsPerContainer": string,
  "servingSizeMeasure": {
    object (FloatUnit)
  },
  "preparedSizeDescription": string,
  "nutritionFactMeasure": string,
  "energy": {
    object (FloatUnit)
  },
  "energyFromFat": {
    object (FloatUnit)
  },
  "totalFat": {
    object (FloatUnit)
  },
  "totalFatDailyPercentage": number,
  "saturatedFat": {
    object (FloatUnit)
  },
  "saturatedFatDailyPercentage": number,
  "monounsaturatedFat": {
    object (FloatUnit)
  },
  "polyunsaturatedFat": {
    object (FloatUnit)
  },
  "transFat": {
    object (FloatUnit)
  },
  "transFatDailyPercentage": number,
  "cholesterol": {
    object (FloatUnit)
  },
  "cholesterolDailyPercentage": number,
  "sodium": {
    object (FloatUnit)
  },
  "sodiumDailyPercentage": number,
  "totalCarbohydrate": {
    object (FloatUnit)
  },
  "totalCarbohydrateDailyPercentage": number,
  "dietaryFiber": {
    object (FloatUnit)
  },
  "dietaryFiberDailyPercentage": number,
  "totalSugars": {
    object (FloatUnit)
  },
  "totalSugarsDailyPercentage": number,
  "addedSugars": {
    object (FloatUnit)
  },
  "addedSugarsDailyPercentage": number,
  "protein": {
    object (FloatUnit)
  },
  "proteinDailyPercentage": number,
  "polyols": {
    object (FloatUnit)
  },
  "starch": {
    object (FloatUnit)
  },
  "vitaminD": {
    object (FloatUnit)
  },
  "vitaminDDailyPercentage": number,
  "calcium": {
    object (FloatUnit)
  },
  "calciumDailyPercentage": number,
  "iron": {
    object (FloatUnit)
  },
  "ironDailyPercentage": number,
  "potassium": {
    object (FloatUnit)
  },
  "potassiumDailyPercentage": number,
  "folateMcgDfe": number,
  "folateDailyPercentage": number,
  "folateFolicAcid": {
    object (FloatUnit)
  },
  "voluntaryNutritionFact": [
    {
      object (VoluntaryNutritionFact)
    }
  ]
}
فیلدها
servingSizeDescription

string

میزان پذیرایی استاندارد غذا. شرح میزان پذیرایی استاندارد.

servingsPerContainer

string

تعداد وعده در هر ظرف.

servingSizeMeasure

object (FloatUnit)

اندازه میزان پذیرایی استاندارد.

preparedSizeDescription

string

شرح اندازه آماده‌شده.

nutritionFactMeasure

string

معیار ارزش غذایی.

energy

object (FloatUnit)

ارزش غذایی اجباری. انرژی.

energyFromFat

object (FloatUnit)

انرژی از چربی.

totalFat

object (FloatUnit)

مجموع چربی.

totalFatDailyPercentage

number

درصد روزانه مجموع چربی.

saturatedFat

object (FloatUnit)

چربی اشباع.

saturatedFatDailyPercentage

number

درصد روزانه چربی اشباع.

monounsaturatedFat

object (FloatUnit)

چربی تک‌غیراشباع.

polyunsaturatedFat

object (FloatUnit)

چربی چندغیراشباع.

transFat

object (FloatUnit)

چربی ترانس.

transFatDailyPercentage

number

درصد روزانه چربی ترانس.

cholesterol

object (FloatUnit)

کلسترول.

cholesterolDailyPercentage

number

درصد روزانه کلسترول.

sodium

object (FloatUnit)

سدیم.

sodiumDailyPercentage

number

درصد روزانه سدیم.

totalCarbohydrate

object (FloatUnit)

مجموع کربوهیدرات.

totalCarbohydrateDailyPercentage

number

درصد روزانه مجموع کربوهیدرات.

dietaryFiber

object (FloatUnit)

فیبر خوراکی.

dietaryFiberDailyPercentage

number

درصد روزانه فیبر خوراکی.

totalSugars

object (FloatUnit)

کل قندها.

totalSugarsDailyPercentage

number

درصد روزانه کل قندها.

addedSugars

object (FloatUnit)

شکر افزوده.

addedSugarsDailyPercentage

number

درصد روزانه شکر افزوده.

protein

object (FloatUnit)

پروتئین.

proteinDailyPercentage

number

درصد روزانه پروتئین.

polyols

object (FloatUnit)

پلی‌ال‌ها.

starch

object (FloatUnit)

آهار.

vitaminD

object (FloatUnit)

ویتامین دی.

vitaminDDailyPercentage

number

درصد روزانه ویتامین دی.

calcium

object (FloatUnit)

کلسیم.

calciumDailyPercentage

number

درصد روزانه کلسیم.

iron

object (FloatUnit)

آهن.

ironDailyPercentage

number

درصد روزانه آهن.

potassium

object (FloatUnit)

پتاسیم.

potassiumDailyPercentage

number

درصد روزانه پتاسیم.

folateMcgDfe

number

فولات میکروگرم DFE.

folateDailyPercentage

number

درصد روزانه فولات.

folateFolicAcid

object (FloatUnit)

فولات اسید فولیک.

voluntaryNutritionFact[]

object (VoluntaryNutritionFact)

ارزش غذایی داوطلبانه.

FloatUnit

ترکیب مقدار اعشاری و واحد.

نمایش JSON
{
  "amount": number,
  "unit": string
}
فیلدها
amount

number

مبلغ.

unit

string

واحد.

VoluntaryNutritionFact

ارزش غذایی داوطلبانه.

نمایش JSON
{
  "name": string,
  "value": {
    object (FloatUnit)
  },
  "dailyPercentage": number
}
فیلدها
name

string

نام.

value

object (FloatUnit)

مقدار.

dailyPercentage

number

درصد روزانه.

خواربارفروشی

نمایش JSON
{
  "ingredients": string,
  "activeIngredients": string,
  "allergens": string,
  "directions": string,
  "storageInstructions": string,
  "indications": string,
  "nutritionClaim": [
    string
  ],
  "derivedNutritionClaim": [
    string
  ],
  "alcoholByVolume": number
}
فیلدها
ingredients

string

عناصر.

activeIngredients

string

عناصر فعال.

allergens

string

مواد حساسیت‌زا.

directions

string

مسیرها.

storageInstructions

string

دستورالعمل‌های ذخیره‌سازی.

indications

string

موارد استفاده.

nutritionClaim[]

string

ادعای تغذیه.

derivedNutritionClaim[]

string

ادعای تغذیه‌ای مشتق‌شده.

alcoholByVolume

number

میزان الکل.

گواهی

شرح گواهینامه.

نمایش JSON
{
  "name": string,
  "authority": string,
  "code": string,
  "value": string,
  "link": string,
  "logo": string,
  "validUntil": string,
  "labelLink": string,
  "documentLink": string
}
فیلدها
name

string

الزامی. نام گواهینامه.

authority

string

الزامی. نام نهاد ارائه‌دهنده گواهینامه.

code

string

اختیاری. کد یکتا برای شناسایی گواهینامه.

value

string

اختیاری. مقدار سفارشی گواهینامه.

validUntil

string

اختیاری. تاریخ انقضا (به‌وقت ساعت هماهنگ جهانی).

QuestionAndAnswer

پرسش و پاسخ درباره محصول.

نمایش JSON
{
  "question": string,
  "answer": string
}
فیلدها
question

string

الزامی. نوشتار سؤال.

answer

string

الزامی. نوشتار پاسخ.

VariantOption

گزینه شناسایی گونه برای محصول.

نمایش JSON
{
  "name": string,
  "value": string
}
فیلدها
name

string

الزامی. نام گزینه گونه، مثل «رنگ» یا «سبک بند ساعت».

value

string

الزامی. مقدار گزینه گونه، مثل «قرمز» یا «حلقه میلانی».

RelatedProduct

محصولی مرتبط با این محصول.

نمایش JSON
{
  "relationshipType": string,
  "identifierType": string,
  "identifier": string
}
فیلدها
relationshipType

string

الزامی. رابطه با محصول مرتبط، مانند «ACCESSORY» (لوازم جانبی)، «PART_OF_SET» (بخشی از مجموعه)، «REQUIRED_PART» (قطعه لازم)، «OFTEN_BOUGHT_WITH» (اغلب با این محصول خریداری می‌شود)، «SUBSTITUTE» (جایگزین)، یا «DIFFERENT_BRAND» (برند متفاوت).

identifierType

string

الزامی. نوع شناسه محصول مرتبط، مثل «GTIN» یا «شناسه».

identifier

string

الزامی. شناسه محصول مرتبط.