إعداد الفوترة هو رابط على مستوى الحساب بين حساب على "إعلانات Google" وحساب على الدفعات (يُعرف أيضًا باسم إعداد الفاتورة)، وهو يحدّد بفعالية من تتم فوترته مقابل التكاليف التي تتكبدها ميزانيات حساب إعدادات الفوترة. يقابل كل حساب دفعات فاتورة واحدة.
لمحة عن حسابات الدفعات
تحدّد كل BillingSetup
حساب الدفعات الذي
يتم إصدار فواتير له بالتكاليف التي تتكبدها ميزانيات حسابه. يرتبط حساب الدفعات هذا بملف شخصي
في Payments يكون مسؤولاً في النهاية عن تحصيل الرسوم.
تحتوي إعدادات الفوترة على حقل payments_account
ومجموعة من حقول
payments_account_info
التي تحدّد حساب الدفعات قيد الاستخدام، بما في ذلك ما يلي:
payments_account_info.payments_account_id
: معرّف مكوّن من 16 رقمًا يُستخدم لتحديد حساب الدفعات المرتبط بإعداد الفوترة.payments_account_info.payments_account_name
: اسم حساب الدفعات المرتبط بإعدادات الفوترة. هذا الاسم مطبوع على فواتير شهرية.payments_account_info.payments_profile_id
: معرّف مكوّن من 12 رقمًا يتم استخدامه لتحديد الملف الشخصي للدفع المرتبط بإعداد الفوترة.
إذا كان حساب الدفعات مؤهلاً للفوترة الموحدة، يمكن عندئذ تجميع حسابات "إعلانات 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
ستبدأ في وقت لاحق في المستقبل.