البدء

هذا الدليل مخصّص للمطوّرين الذين يريدون استخدام GameSnacks Partner API للحصول على ألعاب لمراكز الألعاب الخاصة بهم. يفترض هذا الدليل أنّك على دراية بمفاهيم برمجة الويب وتنسيقات بيانات الويب.

المتطلبات الأساسية

قبل البدء، عليك تنفيذ ما يلي:

• يجب أن يكون لديك حساب على AdSense
  الاشتراك في AdSense أو تسجيل الدخول إلى حسابك على AdSense

• التعرّف على AdSense
  إذا لم تكن على دراية بمفاهيم AdSense، ننصحك بقراءة المعلومات التمهيدية حول AdSense وتجربة واجهة AdSense قبل البدء في كتابة الرموز.

• التعرّف على "وحدة تحكّم الشريك" في GameSnacks
  يمكنك الاطّلاع على مزيد من المعلومات حول GameSnacks ووحدة تحكّم الشريك في GameSnacks.

برنامج تعليمي للبدء السريع

اتّبِع الخطوات التالية لتسجيل تطبيقك:

1. سجِّل الدخول إلى Google Cloud Console.
2. اختَر مشروعًا أو أنشِئ مشروعًا.
3. أضِف مشروعك على Google Cloud وعنوان بريدك الإلكتروني إلى القائمة المسموح بها كما هو موضّح أدناه.
4. في "مكتبة واجهات برمجة التطبيقات"، ابحث عن "GameSnacks Partner API" واختَرها.
5. انقر على واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد.
6. انقر على إنشاء بيانات اعتماد > مفتاح API.

7. استخدِم مفتاح واجهة برمجة التطبيقات لإجراء طلب HTTP. يُرجى العِلم أنّه في حال تخطّي هذه الخطوة، سيظهر لك الخطأ 403 PERMISSION_DENIED عند محاولة إجراء طلب البيانات من واجهة برمجة التطبيقات.

   مثال على طلب HTTP:
   https://gamesnackspartner.googleapis.com/v1/accounts/${ACCOUNT_ID}/gamecenters/${GAME_CENTER_ID}/games?key=${API_KEY}

   المكان:

   • ‫ACCOUNT_ID هو رقم تعريف حسابك على GameSnacks.
   • GAME_CENTER_ID هو معرّف مركز الألعاب.
   • API_KEY هو مفتاح واجهة برمجة التطبيقات الذي أنشأته في الخطوة 5.

   لاسترداد ACCOUNT_ID وGAME_CENTER_ID، اطّلِع على إنشاء مركز ألعاب.

إضافة مشروعك على Google Cloud إلى القائمة المسموح بها

لاستخدام GameSnacks Partner API، يجب إدراج مشروعك على Google Cloud وبريدك الإلكتروني في القائمة المسموح بها. لإجراء ذلك، يُرجى ملء نموذج إبداء الاهتمام في GameSnacks.

ملاحظة: سيؤدي تخطّي الإجراء إلى ظهور الخطأ 403 PERMISSION_DENIED.