حالات المنتجات

يمكنك استخدام المورد Product لعرض الحالة التفصيلية منتجات التسوّق:

وباستخدام Content API، يمكنك استرداد حالة المنتج من خلال طلب طريقة ProductStatuses.get. باستخدام Merchant API، يمكنك استرداد المنتج الحالة من خلال استرداد مورد Accounts.Products.

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

المتطلبات

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

• سجِّل حسابك في وجهة.
• قدِّم رمز بلد صالحًا في أي مما يلي:
  • الحقل feedLabel.
  • الحقل shipping.
  • على مستوى الخلاصة.
  • إعدادات الشحن في حسابك

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

يمكنك استرداد مورد Accounts.Products للاطّلاع على حالة أحد المنتجات.

إليك نموذج طلب GET:

GET https://merchantapi.googleapis.com/products/v1beta/{name=accounts/*/products/*}

تحتوي كل الردود من products.get على الحقول التالية:

• 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"
}

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

استخدِم 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: يشير إلى البلدان التي تؤثّر فيها المشكلة في المنتج.