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

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

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

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

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

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

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

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

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

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

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

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

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

لربط حساب جديد على "دفعات Google"، اضبط الحقول التالية في payments_account_info (لا تضبط payments_account):

يوضّح المثال التالي كيفية إنشاء إعدادات فوترة جديدة من معرّف ملف دفع حالي. كما أشرنا سابقًا، يؤدي ذلك أيضًا إلى إنشاء حساب جديد على Payments باسم 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 لم يتم تفعيله بعد باستخدام عملية الإزالة. لا يمكن إلغاء إعدادات الفوترة إلا إذا كان statusPENDING أو إذا كانت APPROVED لبدء الفوترة في وقت ما في المستقبل.

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