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

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

قبل البدء

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

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

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

إنشاء حساب

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

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

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

لاستخدام Merchant API، يجب إنشاء رابط بين مشروعك على Google Cloud وحسابك الأساسي على Merchant Center. يجب إكمال عملية التسجيل هذه لمرة واحدة لكل مشروع على Google Cloud تستخدمه مع Merchant API.

يحقّق التسجيل كمطوّر هدفَين:

  • وهي تربط مشروعك على Google Cloud بحسابك الأساسي على Merchant Center، ما يؤدي إلى إنشاء اتصال رسمي.
  • يتم إنشاء جهة اتصال فنية من خلال منح دور API_DEVELOPER لمستخدم في حسابك على Merchant Center. يتيح ذلك لـ Google إرسال إشعارات مهمة إليك بشأن واجهة برمجة التطبيقات، مثل إشعارات الخدمة ومعلومات حول الميزات الجديدة.

تسجيل مشروعك على Google Cloud

للتسجيل، استدعِ الطريقة developerRegistration.registerGcp. يربط هذا الطلب مشروع Google Cloud الذي تستخدمه لإجراء الطلب بحساب Merchant Center الذي تحدّده في الطلب.

في نص الطلب، يجب تقديم عنوان بريد إلكتروني للمطوّر لاستخدامه كجهة اتصال فنية. يجب أن يكون هذا العنوان مرتبطًا بحساب Google (حساب Google Workspace أو حساب Gmail)، مثل sampleuser@gmail.com. لا يمكن استخدام حسابات الخدمة لأنّها حسابات غير تابعة لمستخدمين حقيقيين ومخصّصة للوصول آليًا وليس للتواصل مع المطوّرين.

  • إذا كان عنوان البريد الإلكتروني يخصّ مستخدمًا في حساب Merchant Center، سيتم منح هذا المستخدم دور API_DEVELOPER.
  • إذا لم يكن عنوان البريد الإلكتروني مرتبطًا بحساب مستخدم حالي، سيتم إرسال دعوة إلى هذا العنوان. على المستلم قبول الدعوة ليتم إضافته كمستخدم جديد لديه دور API_DEVELOPER.

في ما يلي مثال على الطلب:

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

{
  "developerEmail": "{DEVELOPER_EMAIL}"
}

يعرض طلب ناجح مورد DeveloperRegistration، ما يؤكّد الربط بين مشروعك وحسابك.

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

إدارة جهات اتصال المطوِّرين وأذوناتهم

بعد التسجيل، ننصحك بإضافة مطوّرين متعددين ومنحهم حقوق وصول إضافية.

منح أذونات إضافية

يجب أن يكون لديك دور API_DEVELOPER لتلقّي الإشعارات المهمة، ولكن يتضمّن هذا الدور الحد الأدنى من الأذونات في Merchant Center. للسماح لهذا المستخدم بإجراء طلبات أخرى من واجهة برمجة التطبيقات أو إدارة الإعدادات في واجهة مستخدم Merchant Center، عليك منحه أدوارًا إضافية، مثل STANDARD أو ADMIN. لمزيد من المعلومات، يُرجى الاطّلاع على أنواع الأذونات.

يمكنك تعديل حقوق وصول المستخدم باستخدام طريقة accounts.users.patch.

يوضّح المثال التالي كيفية تعديل مستخدم لمنحه الدورَين ADMIN وAPI_DEVELOPER. يتيح ذلك للمستخدم إدارة الحساب بالكامل، وسيتلقّى أيضًا الرسائل المتعلقة بواجهة برمجة التطبيقات.

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{DEVELOPER_EMAIL}?update_mask=access_rights

{
  "access_rights": [
    "ADMIN",
    "API_DEVELOPER"
  ]
}

إضافة مطوّرين احتياطيين

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

يمكنك إضافة مستخدم باستخدام طريقة accounts.users.create أو تعديل مستخدم حالي باستخدام طريقة accounts.users.patch. ننصح بمنح هذا المستخدم كلاً من الدورَين ADMIN وAPI_DEVELOPER.

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

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

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

{
  "primaryProductDataSource": {
    "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": {
    "feedLabel": "US",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

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

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

إدراج منتج

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

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

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

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

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

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

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

السابق
Design
التالي
Overview