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

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

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

يحدِّد كلّ BillingSetup حساب دفعات يتمّ إصدار فواتير له مقابل التكاليف التي تتكبّدها ميزانيات حساباته. هذا حساب ملف الدفع مرتبط بملف دفع هو المسؤول عن الرسوم.

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

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

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

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

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

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

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

في كل PaymentsAccount، يظهر معرّف مدير حساب الدفع في الحقل paying_manager_customer.

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

لربط حساب جديد على "دفعات Google"، اضبط الحقول التالية فيملف 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"، سيؤدي ذلك إلى تسجيل العميل بفعالية في خدمة الفوترة باستخدام ملف تعريف Payments المُشار إليه.

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

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

يمكن أن يكون BillingSetup في إحدى الحالات التالية status:

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

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

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

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

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

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

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