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

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

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

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

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

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

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

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

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

للربط بحساب دفعات حالي، اضبط 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 للبدء في وقت ما في المستقبل.

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