إعداد الفوترة هو رابط على مستوى الحساب بين حساب على "إعلانات 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_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
للبدء في بعض الوقت في المستقبل.