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

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

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

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

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

إذا كان حساب الدفعات مؤهلاً للفوترة الموحدة، يمكن تجميع حسابات "إعلانات 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 ستبدأ في وقت لاحق.