Method: monetization.convertRegionPrices

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

طلب HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/pricing:convertRegionPrices

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
packageName

string

الحقل مطلوب. اسم حزمة التطبيق

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "price": {
    object (Money)
  },
  "productTaxCategoryCode": string
}
الحقول
price

object (Money)

السعر الأوّلي الذي سيتم تحويل المناطق الأخرى منه. السعر غير شامل للضريبة
productTaxCategoryCode

string

اختياريّ. رمز فئة الضريبة المفروضة على المنتج في السياق تحدّد فئة الضريبة المفروضة على المنتجات معدّلات الضرائب على المعاملات التي يتم تطبيقها على المنتج والتي سيتم أخذها في الاعتبار عند احتساب السعر.

في حال عدم ضبط هذه القيمة، سيتم استخدام معدّلات الضريبة لفئة الضريبة التلقائية المفروضة على المنتجات.

يُرجى الرجوع إلى مقالة مركز المساعدة للحصول على مزيد من المعلومات.

نص الاستجابة

رسالة الردّ على monetization.convertRegionPrices

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "convertedRegionPrices": {
    string: {
      object (ConvertedRegionPrice)
    },
    ...
  },
  "convertedOtherRegionsPrice": {
    object (ConvertedOtherRegionsPrice)
  },
  "regionVersion": {
    object (RegionsVersion)
  }
}
الحقول
convertedRegionPrices

map (key: string, value: object (ConvertedRegionPrice))

خريطة من رمز المنطقة إلى سعر المنطقة المحوَّل

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
convertedOtherRegionsPrice

object (ConvertedOtherRegionsPrice)

تم تحويل أسعار المناطق الأخرى إلى الدولار الأمريكي واليورو لاستخدامها في البلدان التي لا يتيح فيها Play استخدام العملة المحلية.
regionVersion

object (RegionsVersion)

يشير إلى إصدار المنطقة الذي تم تحديد الأسعار فيه.

نطاقات الأذونات

يجب توفير نطاق 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)

السعر باليورو الذي سيتم استخدامه للموقع الجغرافي "مناطق أخرى" باستثناء الضرائب