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

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

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

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

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

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

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

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

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

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

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

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

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

لربط حساب دفعات جديد، اضبط الحقول التالية في 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 لم يصبح ساريًا بعد باستخدام عملية الإزالة. لا يمكن إلغاء إعدادات الفوترة إلا إذا كان status PENDING أو إذا كان APPROVED لبدء دورة فوترة في وقت ما في المستقبل.

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