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