تنظیم صورتحساب پیوندی در سطح حساب بین حساب Google Ads و حساب پرداختها (همچنین به عنوان تنظیم فاکتور شناخته میشود) است که به طور مؤثر تعیین میکند چه کسی برای هزینههای متحمل شده توسط بودجه حساب راهاندازی صورتحساب صورتحساب میشود. هر حساب Payments مربوط به یک فاکتور است.
درباره حساب های پرداخت
هر BillingSetup یک حساب Payments را شناسایی می کند که برای هزینه های متحمل شده توسط بودجه حساب خود صورتحساب دریافت می کند. این حساب Payments با نمایه Payments مرتبط است که در نهایت مسئول هزینهها است.
تنظیمات صورتحساب شامل یک قسمت payments_account و گروهی از فیلدهای payments_account_info هستند که مشخص میکنند حساب Payments در حال استفاده است، از جمله موارد زیر:
-
payments_account_info.payments_account_id: یک شناسه 16 رقمی که برای شناسایی حساب Payments مرتبط با تنظیم صورتحساب استفاده میشود. -
payments_account_info.payments_account_name: نام حساب Payments مرتبط با تنظیم صورتحساب. این نام در فاکتورهای ماهانه چاپ می شود. -
payments_account_info.payments_profile_id: یک شناسه 12 رقمی که برای شناسایی نمایه Payments مرتبط با تنظیم صورتحساب استفاده میشود.
اگر یک حساب Payments برای صورتحساب تلفیقی واجد شرایط باشد، میتوان چندین حساب Google Ads را در یک فاکتور با تنظیم تنظیمات صورتحسابشان برای استفاده از یک حساب Payments اساسی گروهبندی کرد.
تنظیمات صورتحساب جدید ایجاد کنید
میتوانید تنظیمات صورتحساب جدید را به حسابهای Payments موجود یا حسابهایی که همزمان ایجاد شدهاند پیوند دهید.
از یک حساب Payments موجود استفاده کنید
برای پیوند با یک حساب Payments موجود ، payments_account روی شناسه منبع یک حساب Payments معتبر تنظیم کنید. با این حال، payments_account_info تغییر ندهید .
میتوانید حسابهای پرداخت موجود را با روش PaymentsAccountService.ListPaymentsAccounts فهرست کنید. PaymentsAccounts برگردانده شده به حساب مدیری که برای احراز هویت استفاده می کنید بستگی دارد.
برای هر PaymentsAccount ، شناسه مدیر پرداخت آن در قسمت paying_manager_customer است.
از یک حساب پرداخت جدید استفاده کنید
برای پیوند با یک حساب Payments جدید، فیلدهای زیر را در 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 Ads اضافه میشود، با استفاده از نمایه Payments مرجع، مشتری را برای صدور صورتحساب ثبتنام میکند.
وضعیت تنظیم صورتحساب
موارد جدید BillingSetup قبل از اجرایی شدن منوط به تأیید هستند. تا آن زمان، status آنها در وضعیت PENDING است.
BillingSetup می تواند در یکی از status های زیر باشد:
| وضعیت تنظیم صورتحساب | توضیحات |
|---|---|
PENDING | در انتظار تایید. |
APPROVED_HELD | تصویب شده اما بودجه اول مربوطه تایید نشده است. این فقط برای تنظیمات صورتحساب پیکربندی شده برای صورتحساب ماهانه ممکن است رخ دهد. |
APPROVED | راه اندازی تایید شد. |
CANCELLED | تنظیم قبل از تأیید توسط کاربر لغو شد. |
تنظیم صورتحساب یک حساب را بازیابی کنید
مانند بسیاری از موجودیتهای دیگر در Google Ads API، BillingSetup با جستجو در GoogleAdsService.SearchStream با استفاده از عبارت جستجوی زبان جستجوی Google Ads که مشخص میکند کدام فیلدها را بازگرداند، واکشی میشود.
هنگامی که یک مرجع به BillingSetup دریافت کردید، می توانید از آن برای ایجاد یک AccountBudgetProposal همانطور که در بودجه حساب توضیح داده شده است استفاده کنید.
تنظیم صورتحساب معلق را لغو کنید
BillingSetup که هنوز اعمال نشده است را می توان با استفاده از عملیات حذف لغو کرد. تنظیمات صورتحساب را فقط در صورتی میتوان لغو کرد که status آنها PENDING باشد یا اگر برای شروع مدتی در آینده APPROVED باشد.