تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

قبل البدء

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

في حال استخدام عملية دمج واجهة برمجة التطبيقات في AppScript باستخدام خدمة Shopping Content Service، سيتم إنشاء مشروع تلقائي على Google Cloud وتفعيل خدمة Merchant API تلقائيًا. ومع ذلك، عليك إكمال عملية تسجيل مطوّر لمرة واحدة قبل استخدام Merchant API. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام خدمة Merchant API في "برمجة التطبيقات".

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

إنشاء حساب

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

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

التسجيل كمطور برامج

لاستخدام Merchant API، يجب ربط حسابك على Merchant Center بمشروعك على Google Cloud باستخدام طريقة تسجيل المطوّرين، وذلك باتّباع الخطوات التالية:

ربط حساب Merchant Center بمشروعك على Google Cloud: تتم الموافقة على الربط تلقائيًا، لأنّ مقدّم الطلب لديه رمز مميّز صالح للوصول أو مفتاح واجهة برمجة تطبيقات من مشروع Google Cloud، وهو مستخدم معتمَد لحساب Merchant Center.
إضافة مستخدم "مطوّر واجهة برمجة التطبيقات" إلى حساب Merchant Center: تضيف واجهة برمجة التطبيقات الخاصة بالتسجيل مستخدمًا من نوع "مطوّر واجهة برمجة التطبيقات" إلى حساب Merchant Center. إذا كان المستخدم موجودًا، سيتم منحه نوع الوصول الجديد. في حال كان المستخدم جديدًا، سيتلقّى دعوة بالبريد الإلكتروني من Merchant Center.

ننصحك باستخدام طريقة accounts.users.create لإضافة مطوّري برامج إضافيين أو احتياطيين لواجهة برمجة التطبيقات من أجل التأكّد من أنّه في حال مغادرة الشخص لمؤسستك أو حذف حسابه، سيظل بإمكانك الحصول على تسجيل صالح للمطوّر.

بعد التسجيل، يمكنك الاطّلاع على حالة التسجيل باستخدام GetDeveloperRegistration أو إلغاء التسجيل باستخدام UnregisterGCP.

مكالمة التسجيل هي

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
  developer_email:"example-email@example.com"
}

بعد تنفيذ الطلب بنجاح، توقَّع الردّ التالي:

{
  "developerRegistration": {
    "name": "accounts/ACCOUNT_ID/developerRegistration",
    "gcpIds": ["GOOGLE_CLOUD_PROJECT_ID"]
  }
}

بعد تسجيل مطوّر واجهة برمجة التطبيقات، يمكنك استخدام طريقة accounts.users.patch لمنحه أدوارًا إضافية، مثل STANDARD وADMIN.

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

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

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

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

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

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

أو

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}

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

{
  "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 لعرض هذا المنتج.

Launch status

Overview