يتم تنظيم عينات التعليمات البرمجية هذه حسب النظام الأساسي أو اللغة. يحتوي كل دليل لغة على README مع مزيد من المعلومات حول كيفية تشغيل العينات لتلك اللغة بالذات. هنا ، نغطي إعداد المصادقة وملف التكوين الشائع المستخدم من قبل جميع العينات.
لمزيد من المعلومات حول واجهات برمجة التطبيقات ، يرجى الرجوع إلى وثائق واجهة برمجة تطبيقات المحتوى للتسوق وواجهة برمجة تطبيقات مركز الشركة المصنعة.
قبل البدء ، تحقق من قسم البدء في واجهة برمجة تطبيقات المحتوى لوثائق التسوق. قد ترغب في استخدام حسابات الخدمة بدلاً من ذلك لتبسيط تدفق المصادقة. تدعم هذه العينات أيضًا باستخدام بيانات الاعتماد الافتراضية للتطبيق.
يشبه إعداد المصادقة لواجهة برمجة تطبيقات الشركة المصنعة API واجهة برمجة تطبيقات المحتوى. فقط تأكد من اختيار API Center Center المصنعة في وحدة التحكم API. يمكن اختيار كلا واجهات برمجة التطبيقات إذا كنت ترغب في تجربة عينات لكل من واجهات برمجة التطبيقات.
قم بإنشاء الدليل $(HOME)/shopping-samples لتخزين التكوين.
إذا كنت غير متأكد من مكان وجود هذا في الإعداد الخاص بك ، فقم بتشغيل العينات (باتباع README الخاص باللغة). ستوفر الأخطاء من العينات المتعلقة بهذا الدليل أو الملفات اللازمة غير الموجودة المسار الكامل للدليل/الملفات المتوقعة.
ضمن هذا الدليل ، قم أيضًا بإنشاء الدلائل الفرعية التالية ، اعتمادًا على واجهة برمجة التطبيقات التي ترغب في تجربتها:
content واجهة برمجة تطبيقات المحتوى للتسوقmanufacturers لمركز الشركة المصنعة APIضع الملفات الموضحة أدناه في الدليل الفرعي المناسب لواجهة برمجة التطبيقات التي تريد تجربتها.
قم بإعداد طريقة المصادقة المطلوبة.
إذا كنت تستخدم بيانات الاعتماد الافتراضية لتطبيق Google:
إذا كنت تستخدم حساب الخدمة:
service-account.json الملفات.إذا كنت تستخدم معرف عميل OAUTH2:
قم بتنزيل بيانات اعتماد عميل OAUTH2 الخاصة بك إلى ملفات client-secrets.json الملفات.
ملاحظة: تفترض العينات أنك تستخدم معرف عميل OAUTH2 يمكنه استخدام عنوان IP للربطة لاسترداد الرموز. إذا لم تكن أو غير متأكد من أنك كذلك ، فيرجى زيارة [OAUTH2.0 لتطبيقات الأجهزة المحمولة وسطح المكتب] (https://developers.google.com/identity/protocols/oauth2installedapp) واتبع التعليمات هناك لإنشاء ملف معرف عميل OAuth2 الجديد لاستخدامه مع العينات.
يمكنك إعداد طرق مصادقة متعددة لتجربة تدفقات مختلفة ، ولكن لاحظ أن العينات ستستخدم دائمًا بيانات الاعتماد الأولى التي يمكن تحميلها ، بالترتيب:
تستخدم كل مجموعة من العينات ملف تكوين مختلف. بالنسبة لواجهة برمجة تطبيقات المحتوى للتسوق ، خذ مثال merchant-info.json من جذر المستودع ونسخه إلى $(HOME)/shopping-samples/content . بعد ذلك ، قم بتغيير محتوياتها بشكل مناسب. أنه يحتوي على كائن JSON مع الحقول التالية:
| مجال | يكتب | وصف |
|---|---|---|
merchantId | رقم | معرف مركز التاجر لتشغيل العينات ضد. |
accountSampleUser | خيط | إذا كان غير فارغ ، فإن عنوان البريد الإلكتروني للمستخدم لإضافة/إزالته في عينات خدمة Accounts . |
accountSampleAdWordsCID | رقم | إذا كان غير صفري ، فإن معرف عميل AdWords لربط/غير مرغوب فيه في عينات خدمة Accounts . |
بالنسبة إلى API Center Center ، خذ مثال manufacturer-info.json من جذر المستودع ونسخه إلى $(HOME)/shopping-samples/manufacturers . بعد ذلك ، قم بتغيير محتوياتها بشكل مناسب. أنه يحتوي على كائن JSON مع الحقول التالية:
| مجال | يكتب | وصف |
|---|---|---|
manufacturerId | رقم | معرف مركز الشركة المصنعة لتشغيل العينات ضد. |
websiteUrl | خيط | عنوان URL (بدون SLASH) المرتبط بحساب مركز الشركة المصنعة. |
إذا كنت تستخدم بيانات اعتماد عميل OAUTH2 ، فبمجرد أن تسمح بالوصول المصرح بها ، سيتم تخزين تفاصيل الرمز المميز في ملف stored-token.json في دليل تكوين العينات. إذا كان لديك أي مشكلات في المصادقة ، فقم بإزالة هذا الملف وسيُطلب منك إعادة تفويض الوصول.
الآن بعد أن قمت بتكوين ملف تكوين العينة الشائع وقمت بإعداد بيانات اعتماد المصادقة الخاصة بك ، فقد حان الوقت لإنشاء وتشغيل أي من العينات المضمنة. كما ذكرنا من قبل ، هناك تعليمات خاصة باللغة في README S الموجودة في كل دليل فرعي للغة. استمتع!
