إعداد الفوترة

إعداد الفوترة هو رابط على مستوى الحساب بين حساب على "إعلانات Google" وحساب على الدفعات (يُعرف أيضًا باسم إعداد الفاتورة)، وهو يحدّد بفعالية من تتم فوترته مقابل التكاليف التي تتكبدها ميزانيات حساب إعدادات الفوترة. يقابل كل حساب دفعات فاتورة واحدة.

لمحة عن حسابات الدفعات

تحدّد كل BillingSetup حساب الدفعات الذي يتم إصدار فواتير له بالتكاليف التي تتكبدها ميزانيات حسابه. يرتبط حساب الدفعات هذا بملف شخصي في Payments يكون مسؤولاً في النهاية عن تحصيل الرسوم.

تحتوي إعدادات الفوترة على حقل payments_account ومجموعة من حقول payments_account_info التي تحدّد حساب الدفعات قيد الاستخدام، بما في ذلك ما يلي:

إذا كان حساب الدفعات مؤهلاً للفوترة الموحدة، يمكن عندئذ تجميع حسابات "إعلانات Google" متعددة في الفاتورة نفسها من خلال ضبط إعدادات الفوترة لاستخدام حساب الدفعات الأساسي نفسه.

إنشاء إعدادات فوترة جديدة

يمكنك ربط إعدادات الفوترة الجديدة بحسابات Payments الحالية أو حسابات تم إنشاؤها في الوقت نفسه.

استخدام حساب Payments حالي

للربط بحساب دفعات حالي، اضبط payments_account على رقم تعريف المورد لحساب دفعات صالح. ولا تعدِّل payments_account_info.

يمكنك إدراج حسابات الدفع المتاحة باستخدام طريقة PaymentsAccountService.ListPaymentsAccounts. تعتمد PaymentsAccounts التي يتم إرجاعها على الحساب الإداري الذي تستخدمه للمصادقة.

لكل PaymentsAccount، يتوفّر رقم تعريف الحساب الإداري للدفع في الحقل paying_manager_customer.

استخدام حساب دفعات جديد

للربط بحساب دفعات جديد، يجب ضبط الحقول التالية في payments_account_info (عدم ضبط payments_account):

يوضح المثال أدناه كيفية إنشاء إعداد فوترة جديد من معرّف ملف الدفع الحالي. كما هو موضح أعلاه، سيؤدي هذا أيضًا إلى إنشاء حساب دفعات جديد باسم My New Payments Account.

BillingSetup bsetup = BillingSetup.newBuilder()
    .setPaymentsAccountInfo(PaymentsAccountInfo.newBuilder()
        .setPaymentsAccountName("My New Payments Account")
        .setPaymentsProfileId("1234-5678-9012")
        .build())
    .setStartTimeType(TimeType.NOW)
    .build();

BillingSetupOperation op = BillingSetupOperation.newBuilder().setCreate(bsetup).build();

try (BillingSetupServiceClient billingSetupServiceClient = googleAdsClient
    .getBillingSetupServiceClient()) {

  MutateBillingSetupResponse response =
      billingSetupServiceClient.mutateBillingSetup(Long.toString(customerId), op);
}

إذا كان هذا هو أول إعداد فوترة تتم إضافته إلى حساب "إعلانات Google"، سيؤدي ذلك إلى اشتراك العميل في الفوترة باستخدام الملف الشخصي للدفع المشار إليه.

حالة إعداد الفوترة

تخضع مثيلات BillingSetup الجديدة للموافقة قبل أن تدخل حيز التنفيذ. وحتى ذلك الحين، تبقى status في حالة PENDING.

يمكن أن تكون BillingSetup في أي مما يلي status:

حالة إعداد الفوترة الوصف
PENDING في انتظار الموافقة.
APPROVED_HELD موافَق عليها، لكن الميزانية الأولى المقابلة لم تتم الموافقة عليها. ولا يمكن أن يحدث ذلك إلا لإعدادات الفوترة التي تم ضبطها لنظام الفواتير الشهرية.
APPROVED تمت الموافقة على عملية الإعداد.
CANCELLED ألغى المستخدم عملية الإعداد قبل الموافقة.

استرداد إعدادات فوترة أحد الحسابات

مثل معظم الكيانات الأخرى في Google Ads API، يتم استرجاع BillingSetup عن طريق إجراء طلب بحث في GoogleAdsService.SearchStream باستخدام طلب بحث لغة طلب البحث في "إعلانات Google" والذي يحدِّد الحقول المطلوب عرضها.

بعد الحصول على مرجع إلى BillingSetup، يمكنك استخدامه لإنشاء AccountBudgetProposal كما هو موضّح في ميزانية الحساب.

إلغاء إعداد فوترة معلَّق

يمكن إلغاء BillingSetup الذي لم يتم تفعيله بعد باستخدام عملية الإزالة. لا يمكن إلغاء عمليات إعداد الفوترة إلا إذا كانت status الخاصة بها PENDING أو إذا كانت APPROVED ستبدأ في وقت لاحق في المستقبل.

السابق
نظرة عامة
التالي
ميزانية الحساب