يوضّح هذا الدليل كيفية استخدام Google Play Developer API لإنشاء كتالوج منتجات لتطبيقك على Google Play وإدارته.
لبيع المنتجات في تطبيقك من خلال نظام الفوترة في Google Play، عليك إعداد كتالوج يتضمّن جميع المنتجات التي تريد إتاحتها للشراء من قِبل المستخدمين. ويمكن إجراء ذلك من خلال Play Console، أو يمكنك برمجة إدارة الكتالوج باستخدام Google Play Developer API. يمكن أن تساعد الأتمتة في ضمان تحديث الكتالوج دائمًا، وتوسيع نطاقه ليشمل الكتالوجات الكبيرة التي يكون التنسيق اليدوي فيها غير عملي. في هذا الدليل، ستتعرّف على كيفية استخدام واجهة برمجة التطبيقات Play Developer API لإنشاء وإدارة كتالوج منتجات لتطبيقك على Google Play. يُرجى مراجعة دليل الاستعداد للحصول على تعليمات حول كيفية إعداد واجهة برمجة التطبيقات Google Play Developer API لعملية الدمج مع الخلفية.
واجهات برمجة التطبيقات لإدارة الكتالوج
للاطّلاع على الأنواع المختلفة للمنتجات التي يمكنك بيعها باستخدام نظام الفوترة في Google Play، يُرجى قراءة مقالة فهم الأنواع المختلفة للمنتجات داخل التطبيق ومعرفة معايير الكتالوج. تقدّم Google مجموعتَين رئيسيتَين من واجهات برمجة التطبيقات لإدارة الكتالوج على Play، وهما تتوافقان مع فئتَي المنتجات الرئيسيَّتين:
- منتجات يتم تحصيل سعرها مرة واحدة
- المنتجات المتوفّرة عند الدفع
منتجات يتم تحصيل سعرها مرة واحدة
تستخدم المنتجات المدفوعة لمرة واحدة (المعروفة سابقًا باسم المنتجات داخل التطبيق) نموذج عناصر المنتجات المدفوعة لمرة واحدة الذي يتيح لك ضبط خيارات شراء وعروض ترويجية متعدّدة لمنتجاتك المدفوعة لمرة واحدة. يوفّر لك نموذج عناصر المنتجات المدفوعة لمرة واحدة مرونة أكبر في طريقة بيع المنتجات، ويقلّل من تعقيد إدارتها. سيتم نقل منتجاتك الحالية داخل التطبيق إلى نموذج عناصر المنتجات التي يتم تحصيل سعرها مرة واحدة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة نقل المنتجات داخل التطبيق.
تتيح لك نقطتا النهاية monetization.onetimeproducts وinappproducts إدارة المنتجات المدفوعة لمرة واحدة من الخلفية. ويشمل ذلك إنشاء المنتجات وتعديلها وحذفها، وإدارة الأسعار ومدى التوفّر. بناءً على طريقة تعاملك مع عمليات شراء المنتجات المدفوعة لمرة واحدة، يمكنك إنشاء نموذج للمنتجات الاستهلاكية (يمكن شراؤها عدة مرات حسب الرغبة) أو الأذونات الدائمة (لا يمكن للمستخدم نفسه الحصول عليها مرتين). يمكنك تحديد المنتجات المدفوعة لمرة واحدة التي يجب أن تكون استهلاكية أو غير استهلاكية.
المنتجات المتوفّرة عند الدفع
تساعدك نقطة النهاية monetization.subscriptions في إدارة المنتجات المتوفّرة عند الاشتراك من الخلفية المخصّصة للمطوّرين. يمكنك تنفيذ إجراءات مثل إنشاء الاشتراكات وتعديلها وحذفها، أو التحكّم في تحديد السعر والتوفّر محليًا. بالإضافة إلى نقطة النهاية monetization.subscriptions، نقدّم أيضًا monetization.subscriptions.basePlans وmonetization.subscriptions.basePlans.offers لإدارة الخطط الأساسية والعروض الترويجية للاشتراكات على التوالي.
الطرق المجمّعة
توفّر نقاط النهاية onetimeproducts وinappproducts وmonetization.subscriptions عددًا من طرق الدفعات التي تتيح استرداد أو إدارة ما يصل إلى 100 عنصر ضمن التطبيق نفسه في الوقت نفسه.
عند استخدام طرق الدُفعات مع تفعيل ميزة "المهلة المسموح بها"، يمكن معالجة كمية أكبر من البيانات، وهي مفيدة بشكل خاص لمطوّري الكتالوجات الكبيرة عند إنشاء الكتالوج الأولي أو تسوية الكتالوج.
وقت استجابة نشر التعديلات مقابل معدّل النقل
بعد اكتمال طلب إنشاء منتج أو تعديله، قد لا تظهر التغييرات
على الفور للمستخدمين النهائيين على أجهزتهم بسبب تأخيرات في معالجة الشبكة أو
الواجهة الخلفية. بشكل تلقائي، تكون جميع طلبات تعديل المنتجات
حساسة لزمن الاستجابة. وهذا يعني أنّها محسَّنة للنشر السريع من خلال أنظمة الخلفية، وتظهر عادةً على أجهزة المستخدمين النهائيين في غضون دقائق.
ومع ذلك، هناك حدّ أقصى لعدد طلبات التعديل هذه في الساعة.
في الحالات التي تحتاج فيها إلى إنشاء العديد من المنتجات أو تعديلها (على سبيل المثال، أثناء إنشاء كتالوج كبير أولي)، يمكنك استخدام طرق مجمّعة مع ضبط الحقل latencyTolerance على PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT. سيؤدي ذلك إلى زيادة معدل نقل البيانات
الخاص بالتحديثات بشكل كبير. ستستغرق التحديثات التي تتحمّل وقت الاستجابة ما يصل إلى 24 ساعة لنشرها على أجهزة المستخدمين النهائيين.
إعدادات الحصة
هناك عدة حدود للحصص يجب أن تكون على دراية بها عند استخدام واجهة برمجة التطبيقات Google Play Developer API لإدارة كتالوج منتجاتك:
- يتم تنظيم واجهات Google Play Developer API في فئات تُسمى "الحِزم"، ولكل حزمة حدّ أقصى للحصة في الدقيقة. لمزيد من المعلومات، يُرجى الاطّلاع على الحصص.
- تفرض نقاط نهاية تعديل المنتجات أيضًا حدًا أقصى يبلغ 7,200 طلب في الساعة. هذا الحدّ الأقصى هو نفسه لكل من المنتجات المدفوعة لمرة واحدة والاشتراكات وجميع طلبات التعديل، بما في ذلك الإنشاء والتعديل والتفعيل والحذف. يتم احتساب طلبات إجراء تعديل مجمّع كطلب واحد لهذه الحصة، بغض النظر عن عدد الطلبات الفردية المضمّنة أو مدى حساسية وقت الاستجابة.
- بالنسبة إلى التعديلات الحساسة لزمن الاستجابة، يبلغ الحد الأقصى المسموح به 7,200 تعديل في الساعة. بالنسبة إلى الطرق المجمّعة، يتم احتساب كل طلب تعديل مدمج بشكل منفصل لغرض هذه الحصة. لا تؤثر هذه الحصة إلا في مستخدمي واجهة برمجة التطبيقات المجمّعة الذين يجرون تعديلات حساسة لزمن الاستجابة، لأنّه في الحالات الأخرى، سيتم استنفاد الحصة 2 قبل هذه الحصة أو في الوقت نفسه.
في ما يلي عدة أمثلة توضيحية لفهم استخدام الحصة في الطلبات المختلفة:
- سيستهلك طلب
getواحد لجلب سلعة واحدة رمزًا مميزًا واحدًا من الحصة 1 ولن يستهلك أي رموز مميزة من الحصتين 2 و3 (لأنّهما يتعلّقان بنقاط نهاية التعديل فقط). - سيستهلك أيضًا طلب
getمجمّع لجلب ما يصل إلى 100 سلعة رمزًا مميزًا واحدًا من الحصة 1 ولن يستهلك أي رموز مميزة من الحصتَين 2 و3. - سيستهلك طلب
modificationواحد لسلعة واحدة رمزًا مميزًا واحدًا من الحصة 1 ورمزًا مميزًا واحدًا من الحصة 2. إذا كان الطلب حساسًا لزمن الاستجابة، سيستهلك أيضًا رمزًا مميزًا واحدًا من الحصة 3. بما أنّ الحصة ج لها الحد نفسه للحصة 2، فليس لها أي آثار عملية على المستخدمين الذين يستخدمون طرق التعديل الفردية فقط. - سيستهلك طلب مجمّع من النوع
modificationلـ 100 عنصر يمكنه تحمّل وقت الاستجابة رمزًا مميزًا واحدًا من الحصة 1 ورمزًا مميزًا واحدًا من الحصة 2. يجب أن يتيح إعداد الحصة هذا هامشًا كافيًا لإبقاء الكتالوج محدّثًا، ولكن إذا لم تكن الخوارزمية على عِلم بهذه الحصة وتجاوزت هذا المعدّل، قد يظهر لك خطأ لكل طلب إضافي. - سيستهلك طلب مجمّع من النوع
modificationلـ 100 عنصر حسّاس لزمن الاستجابة رمزًا مميّزًا واحدًا من الحصة 1 ورمزًا مميّزًا واحدًا من الحصة 2 و100 رمز مميّز من الحصة 3.
اقتراحات بشأن استخدام Catalog Management API
من خلال الالتزام بهذه الإرشادات، يمكنك تحسين تفاعلاتك مع واجهة برمجة التطبيقات، ما يضمن لك تجربة سلسة وفعّالة في إدارة الكتالوج.
مراقبة الاستخدام
يجب أن تكون على دراية بعمليات الاستخدام الكثيف. على سبيل المثال، في بداية عملية التكامل، من المرجّح أن تستهلك نقاط نهاية إدارة الكتالوج حصة أكبر لإنشاء الكتالوج الأولي الكامل، وقد يؤثر ذلك في استخدام نقاط النهاية الأخرى في مرحلة الإنتاج، مثل واجهة API لحالة الشراء، إذا كنت قريبًا من الحدّ الأقصى للاستخدام العام. عليك مراقبة استهلاك حصتك للتأكّد من عدم تجاوز حصص واجهة برمجة التطبيقات. هناك عدة طرق لمراقبة الاستخدام. على سبيل المثال، يمكنك استخدام لوحة بيانات حصص Google Cloud APIs، أو أي أداة أخرى من اختيارك لمراقبة واجهات برمجة التطبيقات، سواء كانت داخلية أو تابعة لجهة خارجية.
تحسين استخدام حصة واجهة برمجة التطبيقات
ننصح بشدة بتحسين معدّل الاستهلاك لتقليل احتمالية حدوث أخطاء في واجهة برمجة التطبيقات. لتنفيذ ذلك بفعالية، ننصحك بما يلي:
- اختيار استراتيجية إدارة الكتالوج المناسبة بعد فهم حصة واجهة برمجة التطبيقات، عليك اختيار الاستراتيجية المناسبة لتطبيقك من أجل تحقيق أهداف إدارة الكتالوج بكفاءة.
- لا تُجرِ سوى الحدّ الأدنى من الطلبات التي تحتاج إليها لتطبيق تغييراتك.
- لا ترسِل طلبات تعديل مكرّرة أو غير ضرورية إلى واجهات برمجة التطبيقات. قد يتطلّب ذلك الاحتفاظ بسجلّ تغييرات في الكتالوج الخلفي.
- يجب عدم تجاوز الحدّ الأقصى لعدد طلبات تعديل المنتجات في الساعة، وهو 7,200 طلب. قد تحتاج إلى إنشاء عمليات مزامنة تتطلّب منك إجراء عدد كبير من تعديلات المنتجات في فترة زمنية قصيرة (على سبيل المثال، إنشاء كتالوج أولي). إذا كنت تتوقع أن تتجاوز هذه العمليات الحدّ الأقصى المسموح به في الساعة، يمكنك تنفيذ عمليات انتظار حسب الضرورة لإبطاء الاستخدام إلى مستوى آمن. ننصحك باستخدام الطرق المجمّعة مع التعديلات التي تتحمّل وقت الاستجابة لتحقيق معدّل نقل بيانات أعلى.
- الاستعداد بشكل استباقي لتوسيع نطاق العمل مع نمو تطبيقك، قد تحتاج إلى توسيع نطاق استخدامك لواجهة برمجة التطبيقات ونقاط النهاية المختلفة. يمكنك الاطّلاع على مستندات حصص Google Play Developer API لمعرفة تفاصيل حول كيفية زيادة حصتك عندما تقترب من الحد الأقصى للاستخدام.
- جدولة العمليات الثقيلة بشكل استراتيجي حاوِل جدولة عمليات الكتالوج الكبيرة في أوقات الذروة الحرجة، على سبيل المثال، يمكنك تجنُّب إجراء مزامنة كاملة للكتالوج خلال أوقات ذروة المبيعات في الأسبوع.
إضافة منطق معالجة أخطاء الحصة
بغض النظر عن مدى كفاءة إنشاء منطق إدارة الكتالوج، يجب أن تجعله مرنًا في التعامل مع حدود الحصة غير المتوقعة، نظرًا لأن الحصة اليومية تتم مشاركتها بواسطة نقاط النهاية المستخدمة في الوحدات المستقلة لعملية التكامل. تأكَّد من تضمين أخطاء تقييد الحصص في معالجة الأخطاء، وتنفيذ فترات الانتظار المناسبة. سيؤدي كل طلب يتم إجراؤه إلى واجهات Google Play Developer API إلى إنشاء
استجابة. في حال تعذّر إجراء الطلب، ستتلقّى ردًا يشير إلى حدوث خطأ
ويتضمّن رمز حالة استجابة HTTP وعنصر errors، ما يوفّر
مزيدًا من التفاصيل حول نطاق الخطأ ورسالة تصحيح الأخطاء. على سبيل المثال، إذا تجاوزت الحدّ اليومي، قد تظهر لك رسالة خطأ مشابهة لما يلي:
{
"code" : 403,
"errors" : [ {
"domain" : "usageLimits",
"message" : "Daily Limit Exceeded. The quota will be reset at midnight Pacific Time (PT). You may monitor your quota usage and adjust limits in the API
Console: https://console.developers.google.com/apis/api/androidpublisher.googleapis.com/quotas?project=xxxxxxx",
"reason" : "dailyLimitExceeded",
"extendedHelp" : "https://console.developers.google.com/apis/api/androidpublisher.googleapis.com/quotas?project=xxxxxx"
} ],
}
تنفيذ إدارة الكتالوج
يستخدم المطوّرون نقاط نهاية نشر المنتجات في Google Play Developer API لإبقاء الكتالوج متزامنًا بين الخلفية وGoogle Play. إنّ التأكّد من أنّ كتالوج Google Play محدَّث دائمًا بأحدث المعلومات في كتالوج الخلفية له مزايا في إنشاء تجربة أفضل للمستخدم. على سبيل المثال:
- ستتمكّن من الاطّلاع على القائمة الكاملة للعروض المتاحة وإدارة علامات العروض والخطط الأساسية للتأثير في أهليتك ومنطق ظهور العروض.
- يمكنك الاطّلاع على نقاط الأسعار وتفاصيل المنتجات المختلفة التي تظهر للمستخدمين على جميع المنصات، والتأكّد من اتساقها.
- ستتوفّر لك تفاصيل المنتج في الخلفية عند معالجة عمليات الشراء الجديدة، بدون الحاجة إلى زيادة وقت الاستجابة ومخاطر الفشل من خلال إجراء طلبات إضافية إلى Google Play Developer API أثناء التدفقات المهمة للمستخدم.
هناك حدود واعتبارات معيّنة يجب وضعها في الاعتبار عند إنشاء كتالوج المنتجات على Google Play. بعد فهم هذه الحدود ومعرفة كيفية تنظيم الكتالوج، يحين وقت تحديد استراتيجية المزامنة.
استراتيجيات مزامنة الكتالوج
تتيح لك نقاط نهاية النشر في Google Play Developer API إجراء تعديلات على كتالوجك عند حدوث تغييرات. في بعض الأحيان، قد تحتاج إلى اتباع نهج التحديثات الدورية، حيث ترسل مجموعة من التغييرات في نفس العملية. يتطلب كل نهج خيارات تصميم مختلفة. Each synchronization strategy will fit some use cases better than others, and you might have a set of needs that calls for both, depending on the situation.
قد تحتاج أحيانًا إلى تعديل منتج فور علمك بتغيير جديد، على سبيل المثال لمعالجة تعديل عاجل للمنتج (أي يجب تصحيح سعر خاطئ في أقرب وقت ممكن). في أوقات أخرى، يمكنك استخدام مزامنة دورية في الخلفية لضمان اتساق الواجهة الخلفية وكتالوجات Play دائمًا. يمكنك الاطّلاع على بعض حالات الاستخدام الشائعة التي قد تحتاج فيها إلى تنفيذ هذه الاستراتيجيات المختلفة لإدارة الكتالوج.
حالات إرسال التعديلات عند تغيير الكتالوج المحلي
من الأفضل إجراء التعديلات فور حدوث أي تغيير في كتالوج المنتجات في الخلفية، وذلك للحدّ من الاختلافات.
يُعدّ هذا النوع من التعديلات خيارًا جيدًا في الحالات التالية:
- يجب التأكّد من أنّ منتجاتك محدَّثة دائمًا.
- عليك إجراء بعض التغييرات على منتجاتك كل يوم.
- يجب تعديل المنتجات التي يتم إنتاجها وبيعها حاليًا.
هذا النهج أسهل في التنفيذ، ويتيح لك الحفاظ على مزامنة الكتالوج مع أقل قدر من التباين.
حالات استخدام التعديلات الدورية
يتم إجراء التعديلات الدورية بشكل غير متزامن مع تعديل المنتج في الخلفية، وهي خيار جيد في الحالات التالية:
- لا حاجة إلى التأكّد من تعديل منتجاتك في غضون مهلة قصيرة.
- تحتاج إلى التخطيط للتعديلات المجمّعة أو عمليات التسوية.
- لديك نظام لإدارة المحتوى أو الكتالوج للتعامل مع منتجاتك الرقمية، ويتم تحديث الكتالوج باستمرار
في حال الكتالوجات الكبيرة، ننصحك باستخدام طرق مجمّعة مع تعديلات تتحمّل وقت الاستجابة لتحقيق أقصى معدل نقل بيانات.
إنشاء كتالوج منتجاتك
إذا كان لديك كتالوج كبير لتحميله على Google Play، يمكنك برمجة عملية التحميل الأولية. يعمل هذا النوع من العمليات الثقيلة بشكل أفضل إذا تم اتباع استراتيجية دورية جنبًا إلى جنب مع طرق الدُفعات التي تتحمل زمن الوصول.
إنشاء منتجات مدفوعة لمرة واحدة
لإنشاء كتالوج المنتجات المدفوعة لمرة واحدة لأول مرة، ننصحك باستخدام طريقة
monetization.onetimeproducts.batchUpdate
أو طريقة inapp_products.insert مع ضبط حقل
allowMissing على true وضبط حقل latencyTolerance على
PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT. سيؤدي ذلك إلى تقليل الوقت المستغرَق لإنشاء الكتالوج ضمن حدود الحصة.
إنشاء منتجات متوفّرة عند الاشتراك
لإنشاء كتالوج كبير للاشتراكات الأولية، ننصحك باستخدام طريقة
monetization.subscriptions.batchUpdate
مع ضبط الحقل allowMissing على true وضبط الحقل latencyTolerance
على PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT. سيؤدي ذلك إلى تقليل الوقت المستغرَق لإنشاء الكتالوج ضمن حدود الحصة.
بالنسبة إلى قوائم الاشتراكات الأصغر حجمًا، توفّر واجهة Google Play Developer API الطريقة
monetization.subscriptions.create.
يمكنك بدلاً من ذلك إنشاء اشتراكات باستخدام طريقة monetization.subscriptions.patch مع مَعلمة allowMissing كما هو موضّح في قسم "تعديلات المنتجات".
تنشئ جميع الطرق السابقة اشتراكات مع خططها الأساسية
(المتوفرة ضمن عنصر الاشتراك). تكون هذه الخطط الأساسية
غير نشطة في البداية. لإدارة حالة الخطط الأساسية، يمكنك استخدام نقطة النهاية monetization.subscriptions.basePlans، بما في ذلك تفعيل خطة أساسية لإتاحتها للشراء. بالإضافة إلى ذلك، تتيح لك نقطة النهاية monetization.subscriptions.basePlans.offers إنشاء العروض وإدارتها.
آخر الأخبار حول المنتج
تتيح لك الطرق التالية تعديل منتجاتك الحالية بكفاءة، ما يضمن توافق عروضك مع آخر التعديلات.
تحديث المنتجات المدفوعة لمرة واحدة
تتوفّر لك الطرق التالية للمساعدة في تعديل المنتجات الحالية التي يتم تحصيل سعرها مرة واحدة.
- monetization.onetimeproducts.batchUpdate
-
inappproducts.patch: يتم استخدام نقطة نهاية التصحيح لتعديل مورد جزئيًا. وهذا يعني أنّه يمكنك تعديل حقول معيّنة تحدّدها في نص الطلب. يتم استخدام نقطة نهاية التصحيح عادةً عندما تحتاج فقط إلى تعديل بعض حقول المورد. -
inappproducts.update: تُستخدَم نقطة نهاية التعديل لتعديل مورد بالكامل. وهذا يعني أنك ستحتاج إلى إرسال كائن المورد بالكامل في نص الطلب. عادةً ما يتم استخدام نقطة نهاية التعديل عند الحاجة إلى تعديل جميع الحقول في مورد معيّن. عند ضبط المَعلمةallowMissingعلىtrueوعدم توفّر معرّف المنتج المقدَّم، ستُدرج نقطة النهاية المنتج بدلاً من تعذُّر العملية. -
inappproducts.batchUpdate: هذه نسخة مجمّعة من نقطة نهاية التعديل، تتيح لك تعديل منتجات متعددة من خلال طلب واحد. استخدِم هذا الحقل مع ضبط حقلlatencyToleranceعلىPRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANTلتحقيق معدّل نقل بيانات أعلى.
تعديل المنتجات المتوفّرة عند الاشتراك
لتعديل الاشتراكات الحالية، يمكنك استخدام طريقة
monetization.subscriptions.patch. تتطلّب هذه الطريقة
المَعلمات التالية:
-
packageName: اسم حزمة التطبيق الذي ينتمي إليه الاشتراك-
productId: معرّف المنتج الفريد للاشتراك
-
-
regionsVersion: إصدار إعدادات المنطقة
يجب تقديم المَعلمة updateMask، إلا إذا كنت بصدد إنشاء اشتراك جديد باستخدام المَعلمة allowMissing. هذه المَعلمة هي قائمة قيم مفصولة بفاصلة للحقول التي تريد تعديلها.
على سبيل المثال، إذا أردت تعديل بطاقة بيانات منتج متوفّر عند الاشتراك فقط،
عليك تحديد الحقل listings للمَعلمة updateMask.
يمكنك استخدام monetization.subscriptions.batchUpdate لتعديل اشتراكات متعددة في الوقت نفسه.
استخدِم هذا الحقل مع حقل latencyTolerance الذي تم ضبطه على
PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT لتحقيق معدل نقل بيانات أعلى.
لتفعيل الخطط الأساسية أو إيقافها أو حذفها أو نقل المشتركين إلى
أحدث إصدارات أسعار الخطط الأساسية، استخدِم نقطة النهاية monetization.subscriptions.basePlans.
بالإضافة إلى ذلك، يمكنك تعديل عروض خططك الأساسية باستخدام طريقة
monetization.subscriptions.basePlans.offers.patch.
تسوية الكتالوج
سواء اخترت تعديل كتالوج Google Play في كل مرة يتغيّر فيها كتالوج الخلفية أو بشكل دوري، إذا كان لديك نظام إدارة كتالوج أو قاعدة بيانات خارج كتالوج Google Play، فقد تحدث حالات لا تتم فيها مزامنة الكتالوج مع الكتالوج في إعدادات تطبيقاتك على Play. قد يكون ذلك بسبب تغييرات طارئة في الكتالوج اليدوي في Console، أو انقطاع الخدمة في نظام إدارة الكتالوج، أو ربما بسبب فقدان أحدث بياناتك.
يمكنك إنشاء عملية تسوية للكتالوج لتجنُّب حدوث تفاوت لفترة طويلة.
Diff system consideration
ننصحك بإنشاء نظام مقارنة لرصد التناقضات والتسوية بين النظامَين. في ما يلي بعض النقاط التي يجب مراعاتها عند إنشاء نظام مقارنة للمساعدة في الحفاظ على مزامنة الكتالوجات:
- فهم نماذج البيانات: الخطوة الأولى هي فهم نماذج البيانات الخاصة بنظام إدارة المحتوى (CMS) للمطوّر وواجهة Google Play Developer API. ويشمل ذلك معرفة أنواع البيانات المختلفة التي يتم تخزينها في كل نظام، وكيفية ربط عناصر البيانات المختلفة ببعضها البعض.
- تحديد قواعد الاختلاف: بعد فهم نماذج البيانات، عليك تحديد قواعد الاختلاف. ستحدد هذه القواعد كيفية مقارنة البيانات في النظامين. على سبيل المثال، قد تحتاج إلى مطابقة معرّفات المنتجات ومقارنة السمات الرئيسية للاشتراك والخطط الأساسية والعروض المرتبطة به.
- تنفيذ خوارزمية المقارنة: بعد تحديد قواعد المقارنة، عليك تنفيذ خوارزمية المقارنة. ستأخذ هذه الخوارزمية البيانات من النظامَين وتقارنها وفقًا للقواعد التي حدّدتها. للحصول على بيانات الكتالوج من Google Play، يمكنك استخدام الطرق
monetization.onetimeproducts.listوmonetization.onetimeproducts.batchGetوinappproducts.listوinappproducts.batchGetوmonetization.subscriptions.listوmonetization.subscriptions.batchGet. - إنشاء تقارير الاختلافات: ستنشئ خوارزمية الاختلافات تقريرًا بالاختلافات. سيعرض هذا التقرير الاختلافات بين النظامَين.
- تسوية الاختلافات: بعد إنشاء تقرير الاختلافات، عليك حلّ الاختلافات. قد يتضمن ذلك تعديل البيانات في نظام إدارة المحتوى (CMS)، أو تعديل البيانات على Google Play باستخدام نقاط نهاية إدارة الكتالوج في واجهة برمجة التطبيقات للمطوّرين، وذلك حسب الطريقة التي تتبعها عادةً لتعديل الكتالوج. لتسوية المنتجات غير المتزامنة، استخدِم نقاط نهاية التعديل كما هو موضّح في قسم "تعديلات المنتجات".
إيقاف المنتج نهائيًا
توفّر واجهة Google Play Developer API الطرق التالية لمساعدتك في إيقاف منتجاتك نهائيًا:
بالنسبة إلى المنتجات التي يتم تحصيل سعرها مرة واحدة:
monetization.onetimeproducts.deletemonetization.onetimeproducts.batchDeleteinappproducts.deleteinappproducts.batchDelete
بالنسبة إلى المنتجات المتوفّرة عند الاشتراك:
monetization.subscriptions.deleteللاشتراكات لا يمكن إزالة الاشتراك بعد تفعيل خطة أساسية واحدة على الأقل.
قد يكون إيقاف منتج نهائيًا ضروريًا في سيناريوهات مختلفة، مثل:
- تم إنشاء الحساب عن طريق الخطأ.
- إيقاف ميزة أو خدمة نهائيًا
ننصحك بدمج عملية إيقاف المنتجات نهائيًا في استراتيجية إدارة الكتالوج.