Google Play Android Developer API

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

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

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

مستند Discovery

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

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

نقطة نهاية الخدمة هي عنوان URL أساسي يحدّد عنوان الشبكة لخدمة واجهة برمجة تطبيقات. قد تتضمن خدمة واحدة نقاط نهاية متعددة للخدمة. تتضمن هذه الخدمة نقطة نهاية الخدمة التالية وجميع عناوين URL الواردة أدناه ذات صلة بنقطة نهاية الخدمة هذه:

  • 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 للإشارة إلى ملف توسيع لملف 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.generatedapks

الطُرق
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: v3.monetization

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

مورد REST: v3.monetization.subscriptions

الطُرق
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.voidedpurchases

الطُرق
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/*}
تتيح هذه السياسة إمكانية تعديل حق وصول المستخدم إلى حساب مطوّر البرامج.