بدء استخدام Merchant API

توضّح هذه الصفحة كيفية إنشاء حساب على Merchant Center وتحميل ملف تعريف منتج باستخدام Merchant API.

قبل البدء

فعِّل Merchant API في مشروعك على Google Cloud.

الانتقال إلى Google Cloud

إنشاء حساب

لاستخدام Merchant API، يجب أن يكون لديك حساب على Merchant Center. لإنشاء حساب على Merchant Center، اطّلِع على مقالة البدء باستخدام Merchant Center.

الانتقال إلى Merchant Center

الحصول على رقم تعريف حسابك

يمكنك الحصول على معرّف الحساب باستخدام accounts.list هذه الطريقة.

يمكنك استخدام Google APIs Explorer لتشغيل طلبات Merchant API. يستخدم "مستكشف واجهات برمجة التطبيقات" بروتوكول Google OAuth 2.0 للمصادقة. قبل تنفيذ الطلبات، تأكَّد من وضع علامة في مربّع الاختيار Google OAuth 2.0.

لمصادقة باستخدام OAuth 2.0، عليك تسجيل الدخول إلى حسابك على Google، ثم تسجيل الدخول إلى "مستكشف واجهات برمجة التطبيقات". عليك أيضًا السماح لخدمة "مستكشف واجهات برمجة التطبيقات" بإدارة بيانات منتجاتك وحساباتك.

يوضّح الطلب التالي كيفية استرداد رقم تعريف حسابك:

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts

بعد تنفيذ الطلب بنجاح، يظهر الردّ التالي:

{
  "accounts": [
    {
      "name": "{ACCOUNT_NAME}",
      "accountId": "{ACCOUNT_ID}",
      "accountName": "{ACCOUNT_DISPLAY_NAME}",
      "timeZone": {
        "id": "America/Los_Angeles"
      },
      "languageCode": "en-US"
    }
  ]
}

انسخ {ACCOUNT_ID} لأنّك ستحتاج إليه لتشغيل طلبات أخرى.

إنشاء مصدر بيانات أساسي للمنتجات

لإدراج منتج، تحتاج إلى مصدر بيانات أساسي للمنتجات. يوضّح الطلب التالي كيفية إنشاء مصدر بيانات يمكنك استخدامه لإدراج منتج في حسابك:

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources HTTP/1.1

{
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "feedLabel": "US"
  },
  "name": "primary-data-source",
  "displayName": "Primary Products Data Source"
}

استبدِل {ACCOUNT_ID} بمعرّف حساب Merchant Center الذي أنشأته.

بعد تنفيذ هذا الطلب بنجاح، يظهر الردّ التالي:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
  "dataSourceId": "{DATASOURCE_ID}",
  "displayName": "Primary Products Data Source",
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "feedLabel": "US",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

انسخ قيمة حقل name لأنّك ستحتاج إليها لإدراج منتج.

يستغرق مصدر البيانات الذي تم إنشاؤه بضع دقائق ليتمكّن من إدراج المنتجات.

يمكنك الاطّلاع على مصدر البيانات هذا في واجهة مستخدم Merchant Center. لمزيد من المعلومات، يُرجى الاطّلاع على كيفية العثور على علامة التبويب "مصادر البيانات".

إدراج منتج

لإدراج نموذج منتج في حسابك، نفِّذ الطلب التالي:

POST https://merchantapi.googleapis.com/products/v1beta/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1

{
  "channel": "ONLINE",
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "attributes": {
    "gender": "Male",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}

استبدِل {DATASOURCE_NAME} بالقيمة التي نسختها في وقت سابق.

بعد تنفيذ هذا الطلب بنجاح، يظهر الردّ التالي:

{
  "name": "accounts/{ACCOUNT_ID}/productInputs/online~en~US~tshirt-123",
  "product": "accounts/{ACCOUNT_ID}/products/online~en~US~tshirt-123",
  "channel": "ONLINE",
  "offerId": "tshirt-123",
  "contentLanguage": "en",
  "feedLabel": "US",
  "attributes": {
    "brand": "New brand",
    "gender": "Male"
  }
}

معرّف المنتج الذي تم إنشاؤه حديثًا هو online~en~US~tshirt-123. يمكنك استخدام الأسلوب accounts.products.get لاسترداد تفاصيل عن هذا المنتج. يمكنك أيضًا استخدام واجهة مستخدم Merchant Center للاطّلاع على هذا المنتج.