راه‌اندازی صورت‌حساب پیوندی در سطح حساب بین حساب Google Ads و حساب «پرداخت‌ها» (که به‌عنوان راه‌اندازی فاکتور نیز شناخته می‌شود) است که به‌طور مؤثر تعیین می‌کند چه کسی برای هزینه‌های ایجادشده توسط بودجه‌های حساب راه‌اندازی صورت‌حساب صورت‌حساب دریافت می‌کند. هر حساب «پرداخت‌ها» مربوط به یک صورت‌حساب است.
درباره حساب پرداخت‌ها
هر BillingSetup یک حساب «پرداخت‌ها» را شناسایی می‌کند
که برای هزینه‌های ایجادشده توسط بودجه‌های حسابش صورت‌حساب دریافت می‌کند. این حساب «پرداخت‌ها» با نمایه پرداخت‌ها مرتبط است که درنهایت مسئول هزینه‌ها است.
تنظیمات صورت‌حساب هم شامل فیلد
payments_account و هم گروهی از فیلدهای
payments_account_info است که حساب پرداخت‌های مورداستفاده را شناسایی می‌کند، ازجمله:
payments_account_info.payments_account_id: شناسه ۱۶ رقمی با قالب رشته‌ای خط‌تیره‌دار (برای مثال،"1234-5678-9012-3456") که برای شناسایی حساب «پرداخت‌ها» مرتبط با راه‌اندازی صورت‌حساب استفاده می‌شود.payments_account_info.payments_account_name: نام حساب «پرداخت‌ها» مرتبط با راه‌اندازی صورت‌حساب. این نام روی صورت‌حساب‌های ماهانه چاپ می‌شود.payments_account_info.payments_profile_id: شناسه ۱۲ رقمی با قالب رشته خط‌تیره‌دار (برای مثال،"1234-5678-9012") که برای شناسایی نمایه «پرداخت‌ها» مرتبط با راه‌اندازی صورت‌حساب استفاده می‌شود.
اگر «حساب پرداخت‌ها» واجدشرایط صورت‌حساب یکپارچه باشد، می‌توان چندین حساب Google Ads را در یک صورت‌حساب گروه‌بندی کرد. برای این کار، تنظیمات صورت‌حساب آن‌ها را طوری تنظیم کنید که از همان «حساب پرداخت‌ها» استفاده کنند.
ایجاد راه‌اندازی‌های جدید صورت‌حساب
می‌توانید تنظیمات صورت‌حساب جدید را به حساب‌های «پرداخت‌ها» موجود یا حساب‌هایی که هم‌زمان ایجاد شده‌اند پیوند دهید.
استفاده از حساب «پرداخت‌ها»ی موجود
برای پیوند دادن به حساب Payments موجود،
payments_account را روی نام منبع حساب Payments
معتبر (برای مثال،
customers/{customer_id}/paymentsAccounts/{payments_account_id}) تنظیم کنید. اما
payments_account_info را اصلاح نکنید.
می‌توانید حساب‌های Payments دردسترس را با روش
PaymentsAccountService.ListPaymentsAccounts فهرست کنید.
اشیاء PaymentsAccount برگردانده‌شده به حساب مدیری که برای اصالت‌سنجی استفاده می‌کنید بستگی دارد.
برای هر PaymentsAccount، نام منبع
مدیر پرداخت‌کننده آن در
فیلد paying_manager_customer قرار دارد.
استفاده از حساب پرداخت‌های جدید
برای پیوند دادن با حساب «پرداخت‌ها» جدید، فیلدهای زیر را در
payments_account_info تنظیم کنید (
payments_account را تنظیم نکنید):
مثال زیر نشان می‌دهد که چگونه می‌توان تنظیم صورت‌حساب جدیدی را از شناسه نمایه پرداخت‌های موجود ایجاد کرد. همان‌طور که قبلاً اشاره شد، این کار همچنین «حساب پرداخت‌های» جدیدی با نام My New Payments Account ایجاد می‌کند.
BillingSetup billingSetup =
BillingSetup.newBuilder()
.setPaymentsAccountInfo(
PaymentsAccountInfo.newBuilder()
.setPaymentsAccountName("My New Payments Account")
.setPaymentsProfileId("1234-5678-9012")
.build())
.setStartTimeType(TimeTypeEnum.TimeType.NOW)
.build();
BillingSetupOperation operation =
BillingSetupOperation.newBuilder().setCreate(billingSetup).build();
try (BillingSetupServiceClient billingSetupServiceClient =
googleAdsClient.getBillingSetupServiceClient()) {
MutateBillingSetupResponse response =
billingSetupServiceClient.mutateBillingSetup(
Long.toString(customerId), operation);
}
اگر این اولین تنظیم صورت‌حساب باشد که به حساب Google Ads اضافه می‌شود، این کار به‌طور مؤثر مشتری را برای صورت‌حساب بااستفاده از نمایه «پرداخت‌های» ارجاع‌شده ثبت‌نام می‌کند.
وضعیت تنظیم صورت‌حساب
نمونه‌های جدید BillingSetup پیش‌از اجرا شدن باید تأیید شوند. تا آن زمان، status او در وضعیت PENDING است.
BillingSetup می‌تواند یکی از مقادیر
status زیر را داشته باشد:
BillingSetupStatus |
شرح |
|---|---|
PENDING |
در انتظار تأیید. |
APPROVED_HELD |
تأیید شده است، اما اولین بودجه مربوطه تأیید نشده است. این اتفاق فقط برای راه‌اندازی‌های صورت‌حساب پیکربندی‌شده برای صورت‌حساب ماهانه رخ می‌دهد. |
APPROVED |
راه‌اندازی تأیید شد. |
CANCELLED |
راه‌اندازی پیش‌از تأیید توسط کاربر لغو شد. |
بازیابی گزینه نحوه پرداخت حساب
Like most other entities in the Google Ads API, a BillingSetup is
fetched by querying GoogleAdsService.Search or
GoogleAdsService.SearchStream using a Google Ads Query Language
(GAQL) query that specifies which fields to return:
SELECT
billing_setup.resource_name,
billing_setup.id,
billing_setup.status,
billing_setup.payments_account,
billing_setup.payments_account_info.payments_account_id,
billing_setup.payments_account_info.payments_account_name,
billing_setup.payments_account_info.payments_profile_id,
billing_setup.payments_account_info.payments_profile_name,
billing_setup.start_date_time,
billing_setup.end_date_time,
billing_setup.end_time_type
FROM billing_setup
وقتی ارجاعی به BillingSetup دریافت کردید،
می‌توانید از آن برای ایجاد AccountBudgetProposal
همان‌طور که در بودجه‌های حساب شرح داده شده است استفاده کنید.
لغو کردن تنظیم صورت‌حساب معلقه
BillingSetup که هنوز اعمال نشده است را می‌توان با ارسال BillingSetupOperation با فیلد remove تنظیم‌شده روی نام منبع راه‌اندازی صورت‌حساب (customers/{customer_id}/billingSetups/{billing_setup_id}) لغو کرد. راه‌اندازی‌های صورت‌حساب را تنها درصورتی می‌توان لغو کرد که status آن‌ها PENDING باشد یا اگر APPROVED شده باشند تا در آینده شروع شوند.