استرداد حالة المنتج

يمكنك استخدام المرجع accounts.products للاطّلاع على الحالة التفصيلية لمنتجاتك على Shopping.

إذا كنت تستخدم Content API for Shopping لإضافة منتجات، يمكنك الاطّلاع على دليل نقل البيانات للتعرّف على كيفية بدء استخدام Merchant Products API.

أنت المسؤول عن الالتزام بسياسات إعلانات Shopping و البيانات المجانية. تحتفظ إعلانات Shopping بالحق في فرض هذه السياسات والردّ عليها بشكل مناسب إذا رصدنا محتوًى أو سلوكًا ينتهكان هذه السياسات.

المتطلبات

للاطّلاع على حالات المنتجات، عليك اتّباع الخطوات التالية:

  • سجِّل حسابك في أحد البرامج.
  • قدِّم رمز بلد صالحًا في أحد البلدان التالية (سيستهدف المنتج اتحاد البلدان المقدَّمة):

الحصول على حالة منتج

استرجع مرجع accounts.products للاطّلاع على حالة منتج معيّن.

في ما يلي نموذج طلب GET:

GET https://merchantapi.googleapis.com/products/v1beta/accounts/ACCOUNT_ID/products/PRODUCT_ID

تتضمّن جميع الردود الواردة من products.get رسالة ProductStatus التي تتضمّن الحقول التالية:

  • creationDate: تاريخ إنشاء المنتج
  • ‫lastUpdateDate: آخر مرة تم فيها تعديل المنتج
  • googleExpirationDate: التاريخ الذي تنتهي فيه صلاحية المنتج.
  • destinationStatuses: الوجهات المقصودة للمنتج والحالات لكل بلد مستهدف
  • itemLevelIssues: قائمة بجميع المشاكل المرتبطة بالمنتج

لا يظهر حقل itemLevelIssues في الردّ إلّا إذا كان المنتج يواجه مشاكل على مستوى السلعة في وقت تقديم طلبك.

في ما يلي مثال على استجابة JSON:

{
"name": "accounts/123/products/online~en~US~1",
"channel": "ONLINE",
"offerId": "1",
"contentLanguage": "en",
"feedLabel": "US",
"dataSource": "accounts/123/dataSources/456",
"attributes": {
  "title": "Color Headphones",
  "description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
  "imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
  "availability": "in stock",
  "brand": "Google",
  "condition": "new",
  "googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
  "gtin": "00050644632143",
  "mpn": "90000007101",
  "price": {
    "amountMicros": "288000",
    "currencyCode": "USD"
  }
},
"productStatus": {
  "destinationStatuses": [
    {
      "reportingContext": "FREE_LISTINGS",
      "disapprovedCountries": [
        "US"
      ]
    }
  ],
  "itemLevelIssues": [
    {
      "code": "pending_phone_verification",
      "severity": "NOT_IMPACTED",
      "resolution": "merchant_action",
      "reportingContext": "FREE_LISTINGS",
      "description": "Unverified phone number",
      "detail": "Go to the Business information page to verify your business phone number",
      "documentation": "https://support.google.com/merchants/answer/10139041",
      "applicableCountries": [
        "US"
      ]
    },
    {
      "code": "pending_initial_policy_review_free_listings",
      "severity": "DISAPPROVED",
      "resolution": "pending_processing",
      "reportingContext": "FREE_LISTINGS",
      "description": "Pending initial review",
      "detail": "Please wait up to 3 business days for the review to be completed",
      "documentation": "https://support.google.com/merchants/answer/2948694",
      "applicableCountries": [
        "US"
      ]
    },
    {
      "code": "url_does_not_match_homepage",
      "severity": "DISAPPROVED",
      "resolution": "merchant_action",
      "attribute": "link",
      "reportingContext": "FREE_LISTINGS",
      "description": "Mismatched domains [link]",
      "detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
      "documentation": "https://support.google.com/merchants/answer/160050",
      "applicableCountries": [
        "US"
      ]
    }
  ],
  "creationDate": "2024-05-27T16:15:31.791730Z",
  "lastUpdateDate": "2024-05-27T16:15:31.791730Z",
  "googleExpirationDate": "2024-06-26T16:15:31.791730Z"
}

استرداد جميع المنتجات المرفوضة

لاسترداد جميع المنتجات المرفوضة أو غير المؤهَّلة، استخدِم طلب accounts.reports.search التالي:

POST https://merchantapi.googleapis.com/reports/v1beta/accounts/{ACCOUNT_ID}/reports:search

{
  "query": "SELECT id,offer_id,feed_label,title FROM product_view WHERE aggregated_reporting_context_status = 'NOT_ELIGIBLE_OR_DISAPPROVED'"
}

لمزيد من المعلومات عن فلترة المنتجات واستردادها باستخدام Merchant Reports API، اطّلِع على مقالة تقييم منتجاتك.

استرداد كل المنتجات التي في انتظار المراجعة

لاسترداد جميع المنتجات التي في انتظار المراجعة، استخدِم الطلب التالي:

POST https://merchantapi.googleapis.com/reports/v1beta/accounts/{ACCOUNT_ID}/reports:search

{
  "query": "SELECT id,offer_id,feed_label,title FROM product_view WHERE aggregated_reporting_context_status = 'PENDING'"
}

إدراج جميع حالات المنتجات

استخدِم products.list لعرض جميع منتجاتك وحالاتها.

يمكنك استخدام المَعلمات التالية لتحسين طلب البحث:

  • ‫pageToken: يُستخدَم للحصول على الصفحات اللاحقة من النتائج. تحتوي كل صفحة على رمز nextPageToken يمكنك استخدامه للانتقال إلى الصفحة التالية في التسلسل.
  • maxResults: الحد الأقصى لعدد النتائج في كل صفحة

في ما يلي نموذج طلب list يتضمّن مَعلمات طلب اختيارية:

GET https://merchantapi.googleapis.com/products/v1beta/{PARENT}/products?maxResults=1&pageToken=5108b52782905aa9

في ما يلي مثال على استجابة JSON:

{
"nextPageToken": "632fd090c95712c6",
"products": [
 {
  "name": "accounts/123/products/online~en~US~1",
  "channel": "ONLINE",
  "offerId": "1",
  "contentLanguage": "en",
  "feedLabel": "US",
  "dataSource": "accounts/123/dataSources/10355371287",
  "attributes": {
    "title": "Color Headphones",
    "description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
    "imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
    "availability": "in stock",
    "brand": "Google",
    "condition": "new",
    "googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
    "gtin": "00050644632143",
    "mpn": "90000007101",
    "price": {
      "amountMicros": "28800000",
      "currencyCode": "USD"
    }
  },
  "productStatus": {
    "destinationStatuses": [
      {
        "reportingContext": "FREE_LISTINGS",
        "disapprovedCountries": [
          "US"
        ]
      }
    ],
    "itemLevelIssues": [
      {
        "code": "pending_phone_verification",
        "severity": "NOT_IMPACTED",
        "resolution": "merchant_action",
        "reportingContext": "FREE_LISTINGS",
        "description": "Unverified phone number",
        "detail": "Go to the Business information page to verify your business phone number",
        "documentation": "https://support.google.com/merchants/answer/10139041",
        "applicableCountries": [
          "US"
        ]
      },
      {
        "code": "pending_initial_policy_review_free_listings",
        "severity": "DISAPPROVED",
        "resolution": "pending_processing",
        "reportingContext": "FREE_LISTINGS",
        "description": "Pending initial review",
        "detail": "Please wait up to 3 business days for the review to be completed",
        "documentation": "https://support.google.com/merchants/answer/2948694",
        "applicableCountries": [
          "US"
        ]
      },
      {
        "code": "url_does_not_match_homepage",
        "severity": "DISAPPROVED",
        "resolution": "merchant_action",
        "attribute": "link",
        "reportingContext": "FREE_LISTINGS",
        "description": "Mismatched domains [link]",
        "detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
        "documentation": "https://support.google.com/merchants/answer/160050",
        "applicableCountries": [
          "US"
        ]
      }
    ],
    "creationDate": "2024-05-27T16:15:31.791730Z",
    "lastUpdateDate": "2024-05-27T16:15:31.791730Z",
    "googleExpirationDate": "2024-06-26T16:15:31.791730Z"
  }
]
}

إنّ طلب productstatuses.list آمن للاختبار في قناة الإصدار العلني لأنّه لا يؤدي إلى إجراء أي تغييرات على بياناتك.

المشاكل على مستوى السلع

تتضمّن كل مشكلة على مستوى السلعة الحقول التالية:

  • code: رمز الخطأ للّقطة
  • severity: شدة المشكلة
  • resolution: يُعلمك ما إذا كان بإمكان التاجر حلّ المشكلة.
  • attribute: اسم السمة المتأثرة
  • ‫reportingContext: سياق إعداد التقارير الذي تنطبق عليه المشكلة.
  • description: وصف المشكلة
  • detail: يوفّر المزيد من المعلومات عن المشكلة.
  • documentation: عنوان URL للمستندات المتعلّقة بالمشكلة
  • applicableCountries: يشير إلى البلدان التي تؤثّر فيها المشكلة في المنتج.