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

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

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

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

يؤدي التسجيل إلى ما يلي:

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

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

للتسجيل باستخدام طريقة 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 للاطّلاع على هذا المنتج. لمزيد من المعلومات حول عرض بيانات منتجاتك ، يُرجى الاطّلاع على نظرة عامة على المنتجات في Merchant Center.