Google Play Android Developer API

يسمح هذا الإعداد لمطوّري تطبيقات Android بالوصول إلى حساباتهم على Google Play. وعلى مستوى عالٍ، يكون سير العمل المتوقع هو "إدراج" تعديل وإجراء التغييرات حسب الضرورة ثم "الالتزام".

الخدمة: androidpublisher.googleapis.com

لطلب هذه الخدمة، ننصحك باستخدام مكتبات البرامج التي توفّرها Google. إذا كان تطبيقك بحاجة إلى استخدام مكتباتك الخاصة لطلب هذه الخدمة، استخدِم المعلومات التالية عند إجراء طلبات بيانات من واجهة برمجة التطبيقات.

مستند Discovery

مستند Discovery هو مواصفات يمكن قراءتها آليًا لوصف واجهات برمجة تطبيقات REST واستخدامها. ويتم استخدامه لإنشاء مكتبات العميل والمكوّنات الإضافية IDE والأدوات الأخرى التي تتفاعل مع Google APIs. ويمكن أن توفّر خدمة واحدة عدة مستندات لاكتشاف المحتوى. توفّر هذه الخدمة مستند الاكتشاف التالي:

نقطة نهاية الخدمة

نقطة نهاية الخدمة هي عنوان URL أساسي يحدِّد عنوان الشبكة لخدمة واجهة برمجة تطبيقات. قد تحتوي خدمة واحدة على نقاط نهاية متعددة للخدمة. تحتوي هذه الخدمة على نقطة نهاية الخدمة التالية وجميع معرّفات الموارد المنتظمة (URI) التالية ذات صلة بنقطة نهاية الخدمة هذه:

  • https://androidpublisher.googleapis.com

مورد REST: v3.applications.deviceTierConfigs

الطُرق
create POST /androidpublisher/v3/applications/{packageName}/deviceTierConfigs
يؤدي هذا الخيار إلى إنشاء إعداد جديد لفئة جهاز.
get GET /androidpublisher/v3/applications/{packageName}/deviceTierConfigs/{deviceTierConfigId}
تعرض إعدادات فئة جهاز معيّنة.
list GET /androidpublisher/v3/applications/{packageName}/deviceTierConfigs
تعرض عمليات ضبط فئات الأجهزة التي تم إنشاؤها، مرتبةً تنازليًا حسب وقت الإنشاء.

مورد REST: v3.edits

الطُرق
commit POST /androidpublisher/v3/applications/{packageName}/edits/{editId}:commit
يلزم إجراء تعديل على التطبيق.
delete DELETE /androidpublisher/v3/applications/{packageName}/edits/{editId}
لحذف تعديل تطبيق
get GET /androidpublisher/v3/applications/{packageName}/edits/{editId}
لإجراء تعديل على التطبيق.
insert POST /androidpublisher/v3/applications/{packageName}/edits
لإنشاء تعديل جديد لأحد التطبيقات.
validate POST /androidpublisher/v3/applications/{packageName}/edits/{editId}:validate
يتيح التحقّق من صحة تعديل التطبيق.

مورد REST: v3.edits.APKs

الطُرق
addexternallyhosted POST /androidpublisher/v3/applications/{packageName}/edits/{editId}/apks/externallyHosted
يُنشئ حزمة APK جديدة بدون تحميل حِزمة APK نفسها على Google Play، بدلاً من استضافة ملف APK على عنوان URL محدَّد.
list GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/apks
يعرض جميع حِزم APK الحالية للتطبيق وتعديلها.
upload POST /androidpublisher/v3/applications/{packageName}/edits/{editId}/apks
POST /upload/androidpublisher/v3/applications/{packageName}/edits/{editId}/apks
يُحمِّل حزمة APK ويضيفه إلى التعديل الحالي.

مورد REST: v3.edits.bundles

الطُرق
list GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/bundles
يدرج جميع حِزم تطبيقات Android الحالية وتعديلها.
upload POST /androidpublisher/v3/applications/{packageName}/edits/{editId}/bundles
POST /upload/androidpublisher/v3/applications/{packageName}/edits/{editId}/bundles
تحميل حزمة تطبيق Android جديدة إلى هذا التعديل

مورد REST: v3.edits.countryavailability

الطُرق
get GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/countryAvailability/{track}
يوضح مدى التوفُّر في البُلدان.

مورد REST: v3.edits.deobfuscationfiles

الطُرق
upload POST /androidpublisher/v3/applications/{packageName}/edits/{editId}/apks/{apkVersionCode}/deobfuscationFiles/{deobfuscationFileType}
POST /upload/androidpublisher/v3/applications/{packageName}/edits/{editId}/apks/{apkVersionCode}/deobfuscationFiles/{deobfuscationFileType}
يتم تحميل ملف إزالة تشويش جديد وإرفاقه بحزمة APK المحدّدة.

مورد REST: v3.edits.details

الطُرق
get GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/details
للاطّلاع على تفاصيل أحد التطبيقات
patch PATCH /androidpublisher/v3/applications/{packageName}/edits/{editId}/details
رمز تصحيح تفاصيل أحد التطبيقات
update PUT /androidpublisher/v3/applications/{packageName}/edits/{editId}/details
تفاصيل تحديث تطبيق

مورد REST: v3.edits.expansionfiles

الطُرق
get GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/apks/{apkVersionCode}/expansionFiles/{expansionFileType}
يجلب إعدادات ملف التوسيع لحزمة APK المحدّدة.
patch PATCH /androidpublisher/v3/applications/{packageName}/edits/{editId}/apks/{apkVersionCode}/expansionFiles/{expansionFileType}
يؤدي هذا الخيار إلى تصحيح إعدادات ملف توسيع ملف APK للإشارة إلى ملف توسيع آخر APK.
update PUT /androidpublisher/v3/applications/{packageName}/edits/{editId}/apks/{apkVersionCode}/expansionFiles/{expansionFileType}
يؤدي هذا الإعداد إلى تعديل إعدادات ملف توسيع ملف APK للإشارة إلى ملف توسيع آخر.
upload POST /androidpublisher/v3/applications/{packageName}/edits/{editId}/apks/{apkVersionCode}/expansionFiles/{expansionFileType}
POST /upload/androidpublisher/v3/applications/{packageName}/edits/{editId}/apks/{apkVersionCode}/expansionFiles/{expansionFileType}
تحميل ملف توسيع جديد وإرفاقه بحزمة APK المحددة.

مورد REST: v3.edits.images

الطُرق
delete DELETE /androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}/{imageType}/{imageId}
لحذف الصورة (حسب التعريف) من التعديل.
deleteall DELETE /androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}/{imageType}
لحذف جميع الصور للغة ونوع الصورة المحدَّدَين
list GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}/{imageType}
تسرد جميع الصور.
upload POST /androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}/{imageType}
POST /upload/androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}/{imageType}
يحمّل صورة للغة ونوع الصورة المحدّدَين وتضيفه إلى التعديل.

مورد REST: v3.edits.listings

الطُرق
delete DELETE /androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}
لحذف بطاقة بيانات متجر مُترجَمة.
deleteall DELETE /androidpublisher/v3/applications/{packageName}/edits/{editId}/listings
لحذف جميع بطاقات بيانات المتجر
get GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}
الحصول على بطاقة بيانات متجر مُترجَمة.
list GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/listings
تعرض هذه البطاقة كلّ بيانات المتجر المترجَمة.
patch PATCH /androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}
تصحيح رمز بطاقة بيانات متجر مترجمة
update PUT /androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}
إنشاء بطاقة بيانات متجر مترجمة أو تعديلها

مورد REST: v3.edits.testers

الطُرق
get GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/testers/{track}
يجذب المختبرين
patch PATCH /androidpublisher/v3/applications/{packageName}/edits/{editId}/testers/{track}
تصحيح المختبِرين
update PUT /androidpublisher/v3/applications/{packageName}/edits/{editId}/testers/{track}
مختبِرو التعديلات.

مورد REST: v3.edits.tracks

الطُرق
get GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/tracks/{track}
لتتبُّع المحتوى
list GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/tracks
تسرد جميع الأغاني.
patch PATCH /androidpublisher/v3/applications/{packageName}/edits/{editId}/tracks/{track}
تصحيح مقطع صوتي
update PUT /androidpublisher/v3/applications/{packageName}/edits/{editId}/tracks/{track}
يتم تعديل المقطع الصوتي.

مورد REST: v3.externaltransactions

الطُرق
createexternaltransaction POST /androidpublisher/v3/{parent=applications/*}/externalTransactions
إنشاء معاملة خارجية جديدة
getexternaltransaction GET /androidpublisher/v3/{name=applications/*/externalTransactions/*}
يحصل على معاملة خارجية حالية.
refundexternaltransaction POST /androidpublisher/v3/{name=applications/*/externalTransactions/*}:refund
يمكن ردّ أموال معاملة خارجية حالية أو ردّ جزء من الأموال.

مورد REST: v3.generate APKs

الطُرق
download GET /androidpublisher/v3/applications/{packageName}/generatedApks/{versionCode}/downloads/{downloadId}:download
يؤدي إلى تنزيل حزمة APK موقَّعة واحدة تم إنشاؤها من حِزمة تطبيق.
list GET /androidpublisher/v3/applications/{packageName}/generatedApks/{versionCode}
تعرض البيانات الوصفية لتنزيل جميع ملفات APK التي تم إنشاؤها من حزمة تطبيقات معيّنة.

مورد REST: v3.grants

الطُرق
create POST /androidpublisher/v3/{parent=developers/*/users/*}/grants
امنح المستخدم إذن الوصول إلى الحزمة المطلوبة.
delete DELETE /androidpublisher/v3/{name=developers/*/users/*/grants/*}
إلغاء جميع أذونات وصول المستخدم إلى الحزمة أو حساب المطوّر المحدّد
patch PATCH /androidpublisher/v3/{grant.name=developers/*/users/*/grants/*}
تُحدِّث إمكانية وصول المستخدم إلى الحزمة المعنية.

مورد REST: v3.inappproducts

الطُرق
delete DELETE /androidpublisher/v3/applications/{packageName}/inappproducts/{sku}
لحذف منتج داخل التطبيق (منتج مُدار أو اشتراك)
get GET /androidpublisher/v3/applications/{packageName}/inappproducts/{sku}
للحصول على منتج داخل التطبيق، ويمكن أن يكون منتجًا مُدارًا أو اشتراكًا.
insert POST /androidpublisher/v3/applications/{packageName}/inappproducts
تنشئ منتجًا داخل التطبيق (منتج مُدار أو اشتراك).
list GET /androidpublisher/v3/applications/{packageName}/inappproducts
تسرد جميع المنتجات داخل التطبيقات، سواء المنتجات أو الاشتراكات المُدارة.
patch PATCH /androidpublisher/v3/applications/{packageName}/inappproducts/{sku}
تصحيح رمز منتج داخل تطبيق (منتج مُدار أو اشتراك).
update PUT /androidpublisher/v3/applications/{packageName}/inappproducts/{sku}
تعدِّل منتجًا داخل التطبيق (منتج مُدار أو اشتراك).

مورد REST: v3.internalappsharingartifacts

الطُرق
uploadapk POST /androidpublisher/v3/applications/internalappsharing/{packageName}/artifacts/apk
POST /upload/androidpublisher/v3/applications/internalappsharing/{packageName}/artifacts/apk
تحميل ملف APK لمشاركة التطبيقات الداخلية
uploadbundle POST /androidpublisher/v3/applications/internalappsharing/{packageName}/artifacts/bundle
POST /upload/androidpublisher/v3/applications/internalappsharing/{packageName}/artifacts/bundle
تحميل حِزمة تطبيق إلى مشاركة التطبيقات الداخلية

مورد REST: الإصدار 3.تحقيق الربح

الطُرق
convertRegionPrices POST /androidpublisher/v3/applications/{packageName}/pricing:convertRegionPrices
تحسب احتساب أسعار المناطق، وفقًا لسعر الصرف المعتمَد اليوم وأنماط الأسعار الخاصة بكل بلد، استنادًا إلى السعر الوارد في الطلب الخاص بمجموعة من المناطق.

مورد REST: الإصدار 3.تحقيق الربح.الاشتراكات

الطُرق
archive POST /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}:archive
أرشفة اشتراك
create POST /androidpublisher/v3/applications/{packageName}/subscriptions
لإنشاء اشتراك جديد.
delete DELETE /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}
لحذف اشتراك
get GET /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}
يقرأ اشتراكًا واحدًا.
list GET /androidpublisher/v3/applications/{packageName}/subscriptions
تسرد جميع الاشتراكات ضمن تطبيق معيّن.
patch PATCH /androidpublisher/v3/applications/{subscription.packageName}/subscriptions/{subscription.productId}
يؤدي إلى تعديل اشتراك حالي.

مرجع REST: v3.monetization.subscriptions.basePlans

الطُرق
activate POST /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:activate
تفعيل خطة أساسية
deactivate POST /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:deactivate
يتم إيقاف خطة أساسية.
delete DELETE /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}
لحذف خطة أساسية
migratePrices POST /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:migratePrices
تنقل بيانات المشتركين الذين يتلقون سعر اشتراك سابقًا إلى السعر المعروض حاليًا للمنطقة المحددة.

مرجع REST: v3.monetization.subscriptions.basePlans.offers

الطُرق
activate POST /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers/{offerId}:activate
لتنشيط عرض الاشتراك.
create POST /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers
إنشاء عرض اشتراك جديد
deactivate POST /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers/{offerId}:deactivate
لإيقاف عرض اشتراك.
delete DELETE /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers/{offerId}
لحذف عرض اشتراك
get GET /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers/{offerId}
يقرأ عرضًا واحدًا
list GET /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers
تسرد جميع العروض ضمن اشتراك معيّن.
patch PATCH /androidpublisher/v3/applications/{subscriptionOffer.packageName}/subscriptions/{subscriptionOffer.productId}/basePlans/{subscriptionOffer.basePlanId}/offers/{subscriptionOffer.offerId}
يؤدي إلى تعديل عرض اشتراك حالي.

مورد REST: v3.orders

الطُرق
refund POST /androidpublisher/v3/applications/{packageName}/orders/{orderId}:refund
لاسترداد أموال اشتراك المستخدم أو طلب الشراء داخل التطبيق.

مورد REST: v3.purchases.products

الطُرق
acknowledge POST /androidpublisher/v3/applications/{packageName}/purchases/products/{productId}/tokens/{token}:acknowledge
تقرّ بشراء منتج داخل التطبيق.
consume POST /androidpublisher/v3/applications/{packageName}/purchases/products/{productId}/tokens/{token}:consume
تستهلك عملية شراء لمنتج داخل التطبيق.
get GET /androidpublisher/v3/applications/{packageName}/purchases/products/{productId}/tokens/{token}
للتحقّق من حالة شراء منتج داخل التطبيق واستهلاكه

مورد REST: v3.purchases.subscriptions

الطُرق
acknowledge POST /androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:acknowledge
الإقرار بشراء اشتراك.
cancel POST /androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:cancel
إلغاء عملية شراء اشتراك مستخدم.
defer POST /androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:defer
تأجيل عملية شراء اشتراكات المستخدم حتى تاريخ انتهاء الصلاحية المحدَّد في المستقبل
get GET /androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}
تتحقّق مما إذا كانت عملية شراء الاشتراك صالحة أم لا وتُعرِض وقت انتهاء صلاحيتها.
refund POST /androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:refund
يتم ردّ الأموال المدفوعة مقابل اشتراك المستخدم، ولكن يظل الاشتراك صالحًا حتى انتهاء صلاحيته، وسيستمر تكراره.
revoke POST /androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:revoke
تردّ المبالغ المدفوعة وتلغي عملية شراء اشتراك المستخدم على الفور.

مورد REST: v3.purchases.subscriptionsv2

الطُرق
get GET /androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}
الحصول على البيانات الوصفية حول الاشتراك

مورد REST: v3.purchases.absedpurchases

الطُرق
list GET /androidpublisher/v3/applications/{packageName}/purchases/voidedpurchases
تعرض عمليات الشراء التي تم إلغاؤها أو ردّ المبالغ المدفوعة أو استرداد المبلغ المدفوع.

مورد REST: v3.reviews

الطُرق
get GET /androidpublisher/v3/applications/{packageName}/reviews/{reviewId}
يحصل على مراجعة واحدة.
list GET /androidpublisher/v3/applications/{packageName}/reviews
تسرد جميع المراجعات.
reply POST /androidpublisher/v3/applications/{packageName}/reviews/{reviewId}:reply
الردود على مراجعة واحدة أو تعديل الرد الحالي

مورد REST: v3.systemAPKs.variants

الطُرق
create POST /androidpublisher/v3/applications/{packageName}/systemApks/{versionCode}/variants
يُنشئ حزمة APK مناسبة للتضمين في صورة نظام من مجموعة حزمات تطبيق Android التي سبق أن تم تحميلها.
download GET /androidpublisher/v3/applications/{packageName}/systemApks/{versionCode}/variants/{variantId}:download
يؤدي هذا الإعداد إلى تنزيل حزمة APK للنظام تم إنشاؤها سابقًا ومناسبة لتضمينها في صورة النظام.
get GET /androidpublisher/v3/applications/{packageName}/systemApks/{versionCode}/variants/{variantId}
تعرض إحدى صيغ APK لنظام التشغيل التي تم إنشاؤها سابقًا.
list GET /androidpublisher/v3/applications/{packageName}/systemApks/{versionCode}/variants
تعرض هذه السياسة قائمة بخيارات APK لنظام التشغيل التي تم إنشاؤها سابقًا.

مورد REST: v3.users

الطُرق
create POST /androidpublisher/v3/{parent=developers/*}/users
امنح مستخدمًا الإذن بالوصول إلى حساب المطوّر المحدّد.
delete DELETE /androidpublisher/v3/{name=developers/*/users/*}
يزيل جميع أذونات وصول المستخدم إلى حساب المطوّر المحدّد.
list GET /androidpublisher/v3/{parent=developers/*}/users
تسرد جميع المستخدمين الذين لديهم الإذن بالوصول إلى حساب المطوّر.
patch PATCH /androidpublisher/v3/{user.name=developers/*/users/*}
يعدِّل إذن وصول المستخدم إلى حساب المطوّر.