REST Resource: accounts.products

المرجع: المنتج

المنتج الذي تمت معالجته، والذي تم إنشاؤه من عدّة product inputs بعد تطبيق القواعد ومصادر البيانات التكميلية. يتطابق هذا المنتج الذي تمت معالجته مع ما يظهر في حسابك على Merchant Center وفي إعلانات Shopping ومساحات العرض الأخرى على 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~en~US~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" }). ويُعدّ ذلك مفيدًا لإرسال السمات التي لا تعرضها واجهة برمجة التطبيقات بشكل صريح، مثل السمات الإضافية المستخدَمة في ميزة "الشراء على 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

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) التي تنطبق فيها المشكلة على العرض

درجة الخطورة

كيفية تأثير المشكلة في عرض المنتج

عمليات التعداد
SEVERITY_UNSPECIFIED غير محدّد
NOT_IMPACTED هذه المشكلة هي تحذير ولا تؤثّر بشكل مباشر في المنتج.
DEMOTED تمّ خفض ترتيب المنتج ومن المرجّح أنّه يحقّق أداءً محدودًا في نتائج البحث.
DISAPPROVED تؤدي المشكلة إلى رفض المنتج.

الطُرق

get

 استرداد المنتج الذي تمت معالجته من حسابك على Merchant Center

list

 تعرض هذه الصفحة المنتجات التي تمت معالجتها في حسابك على Merchant Center.