Method: monetization.convertRegionPrices
تُحتسَب أسعار المناطق باستخدام سعر الصرف اليومي وأنماط الأسعار الخاصة بكل بلد، استنادًا إلى السعر الوارد في الطلب لمجموعة من المناطق.
طلب HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/pricing:convertRegionPrices
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات |
packageName |
string
مطلوب. اسم حزمة التطبيق
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
{
"price": {
object (Money )
}
} |
الحقول |
price |
object (Money )
السعر الأساسي لتحويل الأسعار في المناطق الأخرى السعر بدون ضريبة.
|
نص الاستجابة
رسالة الردّ على monetization.convertRegionPrices
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
الحقول |
convertedRegionPrices |
map (key: string, value: object (ConvertedRegionPrice ))
ربط رمز المنطقة بالسعر المحوَّل للمنطقة عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
|
convertedOtherRegionsPrice |
object (ConvertedOtherRegionsPrice )
أسعار المناطق الأخرى المحوَّلة إلى الدولار الأمريكي واليورو، لاستخدامها في البلدان التي لا يتيح فيها Play استخدام العملة المحلية
|
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher
ConvertedRegionPrice
سعر محوَّل على مستوى منطقة معيّنة
تمثيل JSON |
{
"regionCode": string,
"price": {
object (Money )
},
"taxAmount": {
object (Money )
}
} |
الحقول |
regionCode |
string
رمز المنطقة.
|
price |
object (Money )
السعر المحوَّل شامل الضريبة.
|
taxAmount |
object (Money )
مبلغ الضريبة للسعر المحوَّل.
|
ConvertedOtherRegionsPrice
أسعار المناطق الأخرى المحوَّلة
تمثيل JSON |
{
"usdPrice": {
object (Money )
},
"eurPrice": {
object (Money )
}
} |
الحقول |
usdPrice |
object (Money )
السعر بالدولار الأمريكي لاستخدامه في الموقع الجغرافي "مناطق أخرى" بدون احتساب الضرائب
|
eurPrice |
object (Money )
السعر باليورو المراد استخدامه في الموقع الجغرافي "مناطق أخرى" بدون احتساب الضرائب
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-12-17 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-12-17 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This endpoint calculates region prices using current exchange rates and country-specific pricing patterns."],["The request requires an initial price and the application's package name."],["The response provides converted prices for specified regions, including tax information and prices in USD/EUR for unsupported regions."],["It utilizes gRPC Transcoding for the URL structure and needs `https://www.googleapis.com/auth/androidpublisher` authorization scope."]]],["This API endpoint calculates regional prices for an app based on a provided initial price. It uses a `POST` request to `convertRegionPrices`, including the app's package name as a path parameter. The request body specifies an initial, tax-exclusive `price`. The response includes `convertedRegionPrices`, a map of region codes to converted prices, and `convertedOtherRegionsPrice`, containing USD and EUR prices for regions without local currency support. The process also involves handling tax and authorization via an OAuth scope.\n"]]