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

طلبات البيانات المباشرة من واجهة برمجة التطبيقات

في هذا الأسلوب للتفاعل مع Merchant API، يتم إرسال طلبات أولية إلى نقاط نهاية واجهة برمجة التطبيقات مباشرةً، عادةً عبر HTTP(S). يمكنك التعامل يدويًا مع جوانب مثل إنشاء نص الطلب وتحديد العناوين (بما في ذلك المصادقة) وتحليل الاستجابة.

الخطوة 1: التسجيل كمطور برامج

لاستخدام Merchant API، يجب تسجيل معلومات الاتصال الخاصة بالمطوّر.

يحقّق التسجيل ما يلي:

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

عند التسجيل، يُرجى مراعاة المتطلبات الأساسية والقيود المفصّلة في التسجيل.

للتسجيل باستخدام طريقة developerRegistration.registerGcp، يمكنك البدء بهذا المثال، مع استبدال {DEVELOPER_EMAIL} بعنوان البريد الإلكتروني المناسب في نص الطلب.

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

{
  "developerEmail": "{DEVELOPER_EMAIL}"
}

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

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

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

عند التسجيل:

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

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

الخطوة 2 (أ) منح أذونات إضافية

يجب أن يكون لديك دور 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"
  ]
}

الخطوة 2(ب) إضافة مطوّرين احتياطيين

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

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

الخطوة 3: إنشاء مصدر بيانات أساسي للمنتجات

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

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

{
  "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. لمزيد من المعلومات، يُرجى الاطّلاع على كيفية العثور على علامة التبويب "مصادر البيانات".

الخطوة 4: إدراج منتج

بعد إنشاء مصدر البيانات، حاوِل إدراج منتج فيه. نفِّذ ما يلي مع توفير ACCOUNT_ID الصحيح. استبدِل {DATASOURCE_NAME} بالقيمة التي نسختها سابقًا.

POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME}
{
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "productAttributes": {
    "gender": "MALE",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}

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

{
  "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",
  "productAttributes": {
    "brand": "New brand",
    "gender": "MALE"
  }
}

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

Overview

Client libraries