كل المقالات
دليل عمليمدة القراءة 8 دقائق

أذونات حساب الخدمة في Google Play تحدد من يستطيع استرداد أموال طلباتك، فامنح أضيق مجموعة تؤدي الغرض

إذن واحد في Play Console يتيح لحساب الخدمة استرداد أموال أي طلب وإلغاء أي اشتراك. إليك أذونات حساب الخدمة في Google Play التي تحتاجها أدوات الاسترداد فعلًا، وما يمكن لمفتاح مسرّب أن يفعله في كل متجر، وكيف تحدد نطاق المفاتيح وتدوّرها وتلغيها.

مفتاح نحاسي على مكتب داكن بجوار حاسوب محمول وهاتف، يرمز إلى أذونات حساب الخدمة في Google Play التي تتحكم في عمليات الاسترداد

أهم الخلاصات

  • يتيح إذن Manage orders and subscriptions (إدارة الطلبات والاشتراكات) في Google Play لحامله عرض الطلبات واسترداد أموالها وإلغاء الاشتراكات، لذا فإن أي حساب خدمة يحمله يستطيع إعادة الأموال إلى المشترين.
  • يذكر دليل Play Developer API من Google أن Google Play Billing APIs تحتاج إلى إذنين في Play Console: View financial data, orders, and cancellation survey responses، وManage orders and subscriptions.
  • تستطيع الطريقة orders.refund في Google Play Developer API استرداد أموال أي طلب شراء لمرة واحدة أو اشتراك يصل عمره إلى 3 سنوات، وعند ضبط revoke على true ينتهي وصول المشتري فورًا.
  • مفاتيح حسابات الخدمة في Google Cloud لا تنتهي صلاحيتها افتراضيًا، وتقول Google إن المفتاح الذي أُودع في مستودع شيفرة يجب حذفه من IAM، لأن إزالته من المستودع لا تكفي.
  • لا يستطيع In-App Purchase key من Apple إصدار عمليات استرداد، لكنه يستطيع استدعاء App Store Server API، بما في ذلك نقاط النهاية التي تمدد تواريخ تجديد الاشتراكات حتى 90 يومًا، وهو تمديد تقول Apple إنه لا يمكن التراجع عنه.
  • لا يستطيع إنشاء In-App Purchase key في App Store Connect إلا Account Holder أو Admin، ولا يُنزَّل المفتاح الخاص إلا مرة واحدة، ولا يمكن إعادة تفعيل مفتاح أُلغي.

امنح حساب خدمة واحدًا إذنين في Play Console، وسيصبح قادرًا على استرداد أموال أي طلب في تطبيقك. هذا ليس خطأ في الإعداد. بل هو بالضبط الطريقة التي بنت بها Google واجهة Google Play Developer API، ولهذا يستحق مفتاح JSON الذي تعمل به أدوات الاسترداد لديك العناية نفسها التي تمنحها لبيانات الدخول إلى حسابك المصرفي.

تُعدّ معظم الفرق هذا الأمر مرة واحدة، تحت ضغط موعد نهائي، بتفعيل كل ما جعل أول استدعاء API ينجح. هذا الدليل يسلك الاتجاه المعاكس. فهو يحدد أذونات حساب الخدمة في Google Play التي يحتاجها عمل الاسترداد والاعتراض على المدفوعات فعلًا، وما يسمح به كل متجر لمفتاح مسروق، وكيف تُبقي نطاق الضرر صغيرًا.

ما الذي تتيحه أذونات حساب الخدمة في Google Play فعلًا

حساب الخدمة مستخدم آلي. تنشئه في Google Cloud، ثم تدعو عنوان بريده الإلكتروني في Play Console ضمن Users and permissions (المستخدمون والأذونات)، تمامًا كما تدعو زميلًا. ومن تلك اللحظة يستطيع أن يفعل كل ما تسمح به تلك الأذونات، عبر API، في أي ساعة، ومن دون أي عامل تحقق ثانٍ.

الإذنان اللذان تتطلبهما واجهات الفوترة

دليل Play Developer API من Google واضح. لاستخدام Google Play Billing APIs تمنح إذنين: View financial data, orders, and cancellation survey responses (عرض البيانات المالية والطلبات وردود استبيان الإلغاء)، وManage orders and subscriptions (إدارة الطلبات والاشتراكات). الأول يتيح للحساب قراءة الطلبات واستخدام Purchases API. والثاني هو الذي يمس المال.

إذن Play Consoleما تقول Google إنه يتيحههل يستطيع إعادة الأموال إلى المشترين
View financial data, orders, and cancellation survey responsesعرض التقارير المالية وتقارير المبيعات والطلبات، والوصول إلى Purchases API، وتنزيل ردود استبيان الإلغاءلا
Manage orders and subscriptionsعرض الطلبات، واسترداد أموال الطلبات، وإلغاء الاشتراكاتنعم
Admin (جميع الأذونات)كل الأذونات الأخرى، إضافة إلى دعوة المستخدمين وتغيير أذوناتهمنعم، ويستطيع منح نفسه المزيد

ما الذي يستطيع مفتاح يملك صلاحيات الاسترداد فعله

تسترد الطريقة orders.refund في Google Play Developer API أموال طلب اشتراك أو شراء داخل التطبيق لمستخدم ما. تقول Google إن الطلبات التي يزيد عمرها على 3 سنوات لا يمكن استرداد أموالها، ما يعني أن كل ما هو أحدث يمكن استرداده. اضبط revoke على true وينتهي وصول المشتري فورًا. وبالنسبة إلى الاشتراكات، تؤدي purchases.subscriptionsv2.revoke مع استرداد كامل المهمة نفسها.

هذه هي الأدوات الصحيحة حين تقصد استخدامها. فإرشادات Google نفسها بشأن الاحتيال تطلب منك استرداد أموال عملية شراء تفشل في عمليات التحقق لديك وإلغاءها بدلًا من تركها تنتهي مهلتها. المشكلة هي مفتاح يستطيع فعل ذلك لكل تطبيق في حسابك بينما كان يحتاجه لتطبيق واحد فقط.

كم قد يكلفك مفتاح مسرّب من المال

احسب الأرقام قبل أن تقرر مقدار الجهد الذي يستحقه هذا الأمر. في Google Play، يستطيع مفتاح يحمل Manage orders and subscriptions استرداد أموال الطلبات باستدعاء تلو الآخر، وكل استرداد يعيد قيمة البيع إلى المشتري. والنص البرمجي لا يتعب. السقف هو سجل طلباتك خلال آخر 3 سنوات.

التكاليف التي لا تعود مع الاسترداد

الاسترداد يلغي البيع. لكنه لا يلغي ما أنفقته لتقديم الخدمة. يبقى ذلك الإنفاق في دفاترك سواء كان الاسترداد باختيار العميل أو بفعل مهاجم.

  • قدرة حوسبة شغّلتها بالفعل: وقت GPU والخوادم وراء كل عملية توليد أو تصيير أو استجابة نموذج تلقاها المشتري.
  • استدعاءات API دفعت ثمنها بالفعل: رسوم كل طلب لدى مزودي النماذج أو الخرائط أو الكلام أو البيانات.
  • تخزين تواصل الدفع مقابله: الملفات والسجلات التي لا تزال تلك الحسابات تحتفظ بها على خوادمك.
  • مدفوعات أرسلتها بالفعل: مستحقات صناع المحتوى أو الشركاء أو البائعين المرتبطة بتلك المشتريات لا تعود مع الاسترداد.

الجانب الخاص بـ Apple له شكل مختلف

لا تحتوي App Store Server API من Apple على أي نقطة نهاية تصدر استردادًا. Apple هي التي تقرر عمليات الاسترداد. لكن In-App Purchase key نفسه يستطيع تمديد تاريخ تجديد مشترك حتى 90 يومًا، مرتين خلال 365 days (365 يومًا) لكل عميل، أو لكل المشتركين النشطين في منتج ما بطلب جماعي واحد. تقول Apple إن التمديد لا يمكن التراجع عنه. وخلال تلك الأيام لا يُحاسَب المشترك ويظل يستخدم تطبيقك، فتستمر فواتير الحوسبة والتخزين وAPI لديك دون أي إيراد مقابل.

ما يستطيع مفتاح مسروق فعلهحساب خدمة Google Play يحمل Manage orders and subscriptionsApple In-App Purchase key
استرداد أموال طلبنعم، طلبات يصل عمرها إلى 3 سنواتلا، Apple وحدها تسترد الأموال
إنهاء وصول المشترينعم، revoke عند الاستردادلا
إلغاء الاشتراكات أو تمديدهاالإلغاء، نعمتمديد تواريخ التجديد حتى 90 يومًا، بلا رجعة
قراءة بيانات المشترياتنعم، مع إذن العرضنعم، سجل المعاملات والاستردادات
الرد على مراجعات الاستردادنعم، orders.reviewrefundنعم، Send Consumption Information
تقييد النطاق بتطبيق واحدنعم، عبر أذونات التطبيقلا، المفتاح يعمل على كل تطبيقات فريقك

كيف تحدد نطاق أذونات حساب الخدمة في Google Play

يفصل Play Console بين أذونات الحساب وأذونات التطبيق. أذونات التطبيق لا تنطبق إلا على التطبيقات التي تختارها. هذا الإعداد الواحد يفيد أمانك أكثر من أي شيء آخر في هذه القائمة.

امنح الإذن على تطبيق واحد، لا على الحساب كله

ادعُ كل حساب خدمة بأذونات تطبيق على التطبيقات التي يخدمها فقط. أداة استرداد لإحدى الألعاب لا تحتاج إلى صلاحيات استرداد على تطبيق التأمل لديك. انتبه إلى فخ واحد: إذن View financial data, orders, and cancellation survey responses موجود على مستوى الحساب فقط، ومقابله على مستوى التطبيق اسمه View financial data. اختر إذن مستوى التطبيق عند تحديد النطاق.

افصل القراءة عن الاسترداد

ليست كل مهمة بحاجة إلى Manage orders and subscriptions. أدوات التحليلات التي تقرأ الطلبات فقط يمكن أن تعمل على حساب لا يملك سوى صلاحيات العرض. احتفظ بالمفتاح القادر على الاسترداد في الخدمة الوحيدة التي تستدعي فعلًا orders.refund أو orders.reviewrefund أو نقاط نهاية revoke.

لا تمنح Admin لأي حساب آلي أبدًا

يمنح Admin كل الأذونات، وتذكر Google ضمن صلاحياته دعوة المستخدمين وإدارة أذوناتهم. مفتاح Admin مسرّب يستطيع توسيع صلاحياته بنفسه أو دعوة شخص جديد. لا يحتاجه أي سير عمل للاسترداد.

اسأل المزودين عن طريقة اتصالهم

بعض الأدوات تطلب منك رفع مفتاح JSON. وأخرى تعطيك البريد الإلكتروني لحساب الخدمة الخاص بها لتدعوه، فلا يغادر أي مفتاح من مفاتيحك سيطرتك أبدًا، ويمكنك إزالة وصولهم من Users and permissions بنقرة واحدة. إذا احتاج مزود إلى صلاحيات استرداد، فاسأل: أي أذونات، وعلى أي تطبيقات، ولماذا.

مطور على مكتب يلغي صلاحيات الوصول على حاسوب محمول، مع صف من المفاتيح على خطافات في الجدار وخطاف واحد فارغ، توضيحًا لكيفية إزالة أذونات حساب الخدمة في Google Play

كيف تخزّن المفاتيح وتدوّرها وتلغيها

يقول المتجران الشيء نفسه بكلمات مختلفة. لا تضع المفاتيح في مستودع شيفرة ولا تضمّنها في تطبيقك. الاختلاف يكمن فيما يحدث بعد أن يقع خطأ ما.

مفاتيح Google Cloud لا تنتهي صلاحيتها من تلقاء نفسها

تشير إرشادات Google Cloud إلى أن مفاتيح حسابات الخدمة ليس لها وقت انتهاء صلاحية افتراضيًا. وتوصي بتدويرها بانتظام وتعطيل المفاتيح التي لم تعد تستخدمها. وإذا وصل مفتاح إلى مستودع، تقول Google إن عليك حذفه من IAM بأسرع ما يمكن، لأن حذفه من المستودع لا يكفي. ويستطيع Google Cloud أيضًا تعطيل المفاتيح المسرّبة التي يكتشفها تلقائيًا عند ضبط القيد Service Account Key Exposure Response على DISABLE_KEY، لكنه لا يضمن اكتشاف كل تسريب.

مفاتيح Apple تُنزَّل مرة واحدة وتُلغى نهائيًا

لا يستطيع إنشاء In-App Purchase key إلا Account Holder أو Admin. تحتفظ Apple بالنصف العام، وتنزّل أنت ملف .p8 الخاص مرة واحدة، ولا تحتفظ Apple بنسخة منه. إذا اشتبهت في أن مفتاحًا تعرض للاختراق، تقول Apple إن عليك إلغاءه فورًا في App Store Connect ضمن Users and Access, Integrations, In-App Purchase. لا يمكن إعادة تفعيل مفتاح أُلغي، وإلغاؤه يوقف أيضًا استخدام العروض الترويجية الموقّعة به، لذا حدّث تلك العروض قبل الإلغاء أو بعده مباشرة.

المهمةحساب خدمة Google PlayApple In-App Purchase key
من يستطيع إنشاؤهيُنشأ في Google Cloud، ثم يُدعى في Users and permissions ضمن Play ConsoleAccount Holder أو Admin
هل يمكنك تنزيل السر مرة أخرىتنشئ مفتاحًا جديدًالا، تنزيل واحد فقط
انتهاء الصلاحية الافتراضيلا يوجدلا يوجد، حتى تلغيه
كيف تقطع الوصول بسرعةاحذف المفتاح في IAM، أو أزل الحساب من Play Consoleألغِ المفتاح في App Store Connect
الآثار الجانبية لقطع الوصولكل أداة تستخدم ذلك الحساب تتوقف عن استدعاء APIالعروض الترويجية الموقّعة به تتوقف عن العمل

قائمة تحقق قصيرة

  • حساب خدمة واحد لكل مهمة، مدعو بأذونات تطبيق على التطبيقات التي يخدمها فقط.
  • إذن Manage orders and subscriptions فقط على الحساب الذي يسترد الأموال أو يلغي الوصول أو يرد على المراجعات فعلًا.
  • لا Admin على أي حساب آلي.
  • المفاتيح في مدير أسرار، وليس أبدًا في مستودع أو سجل بناء أو تطبيق جوال.
  • قائمة مكتوبة بكل مفتاح، ومن أنشأه، وأي خدمة تستخدمه، حتى لا يعطل الإلغاء ردود الاسترداد لديك.
  • مراجعة Users and permissions في Play Console ومفاتيح App Store Connect كلما غادر أحد الفريق أو جرى الاستغناء عن مزود.

الأسئلة الشائعة

ما أذونات Play Console التي يحتاجها حساب الخدمة لعمليات الاسترداد والاعتراض على المدفوعات؟
يحتاج إلى Manage orders and subscriptions لاسترداد أموال الطلبات وإلغاء الاشتراكات والتعامل مع الطلبات، إضافة إلى صلاحية عرض الطلبات. يذكر دليل Play Developer API من Google أن View financial data, orders, and cancellation survey responses وManage orders and subscriptions هما الإذنان اللذان تتطلبهما Google Play Billing APIs.
هل يستطيع حساب خدمة Google Play استرداد أموال الطلبات؟
نعم، إذا كان يحمل إذن Manage orders and subscriptions. تقول صفحة المساعدة من Google إن هذا الإذن يتيح للمستخدمين عرض الطلبات واسترداد أموالها وإلغاء الاشتراكات، وتسترد طريقة orders.refund في API أموال أي طلب يصل عمره إلى 3 سنوات.
هل يستطيع شخص يملك App Store In-App Purchase key الخاص بي استرداد أموال عملائي؟
لا. لا تحتوي App Store Server API على نقطة نهاية للاسترداد، لأن Apple هي التي تتخذ قرارات الاسترداد. ومع ذلك يستطيع مفتاح مسروق قراءة سجل المعاملات والاستردادات، وإرسال معلومات الاستهلاك، وتمديد تواريخ تجديد الاشتراكات حتى 90 يومًا، وهو ما تقول Apple إنه لا يمكن التراجع عنه.
هل تنتهي صلاحية مفاتيح حسابات الخدمة في Google Play؟
ليس افتراضيًا. تقول إرشادات Google Cloud إن المفاتيح التي تنشئها وتنزّلها ليس لها وقت انتهاء صلاحية ما لم تضبطه، وتوصي بتدوير المفاتيح بانتظام وتعطيل ما لم تعد تستخدمه.
ماذا أفعل إذا أُودع مفتاح JSON لحساب الخدمة الخاص بي في GitHub؟
احذف المفتاح من Google Cloud IAM فورًا وأنشئ مفتاحًا جديدًا. تقول Google إن إزالة المفتاح من المستودع لا تكفي، لأن أي شخص نسخه يستطيع مواصلة استخدامه إلى أن يُحذف المفتاح نفسه.

المصادر وقراءات إضافية

RefundHalt

الطيار الآلي للاستردادات في App Store وGoogle Play

تابع القراءة

طلب الاسترداد التالي في طريقه إليك بالفعل.

أعد RefundHalt في الوقت الذي تستغرقه لقراءة رسالة دعم أخرى عن استرداد لم تتمكن من الاعتراض عليه.