הגדרת החיוב היא קישור ברמת החשבון בין חשבון Google Ads לבין חשבון תשלומים (שנקרא גם הגדרת חשבונית), שקובעת ביעילות מי יחויב בעלויות שנצברו בתקציבי החשבון של הגדרת החיוב. כל חשבון תשלומים מקביל לחשבונית אחת.
מידע על חשבונות תשלומים
כל BillingSetup
מזהה חשבון תשלומים שמחויב בחשבונית על עלויות שקשורות לתקציבי החשבון. חשבון התשלומים הזה משויך לפרופיל תשלומים שבסופו של דבר אחראי לחיובים.
הגדרות החיוב כוללות גם את השדה payments_account
וגם קבוצה של שדות payments_account_info
שמזהים את חשבון התשלומים שנמצא בשימוש, כולל:
payments_account_info.payments_account_id
: מזהה בן 16 ספרות שמשמש לזיהוי חשבון התשלומים שמשויך להגדרת החיוב.payments_account_info.payments_account_name
: השם של חשבון התשלומים שמשויך להגדרת החיוב. השם הזה מודפס על חשבוניות חודשיות.payments_account_info.payments_profile_id
: מזהה בן 12 ספרות המשמש לזיהוי פרופיל התשלומים המשויך להגדרת החיוב.
אם חשבון תשלומים עומד בדרישות לחיוב מאוחד, אפשר לקבץ מספר חשבונות Google Ads באותה חשבונית. לשם כך, יש לקבוע את הגדרות החיוב כך שישתמשו באותו חשבון תשלומים בסיסי.
יצירה של הגדרות חיוב חדשות
אפשר לקשר הגדרות חיוב חדשות לחשבונות תשלומים קיימים או לחשבונות שנוצרו במקביל.
באמצעות חשבון תשלומים קיים
כדי לקשר לחשבון תשלומים קיים, צריך להגדיר את payments_account
למזהה המשאב של חשבון תשלומים תקין. עם זאת, לא לשנות את payments_account_info
.
אתם יכולים להציג את רשימת חשבונות התשלומים הזמינים באמצעות אמצעי התשלום PaymentsAccountService.ListPaymentsAccounts
. הערך של PaymentsAccounts
שמוחזר תלוי בחשבון הניהול שבו משתמשים לאימות.
בכל PaymentsAccount
, המזהה של חשבון הניהול שדרכו מתבצע התשלום מופיע בשדה paying_manager_customer
.
שימוש בחשבון תשלומים חדש
כדי לקשר לחשבון Payments חדש, צריך להגדיר את השדות הבאים בשדה 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 Ads, הפעולה הזו תרשום את הלקוח לחיוב באמצעות פרופיל התשלומים הרלוונטי.
סטטוס הגדרת החיוב
מופעים חדשים של BillingSetup
כפופים לאישור לפני שהם נכנסים לתוקף. עד אז, האפשרות status
תהיה במצב PENDING
.
BillingSetup
יכול להיות באחת מהפלטפורמות הבאות status
:
סטטוס הגדרת החיוב | תיאור |
---|---|
PENDING |
בהמתנה לאישור. |
APPROVED_HELD |
אושר, אבל התקציב הראשון התואם לא אושר. מצב כזה יכול לקרות רק בהגדרות חיוב של חיוב חודשי. |
APPROVED |
ההגדרה אושרה. |
CANCELLED |
ההגדרה בוטלה על ידי המשתמש לפני האישור. |
אחזור של הגדרת החיוב מהחשבון
כמו רוב הישויות האחרות ב-Google Ads API, הקוד BillingSetup
מאוחזר באמצעות שאילתה GoogleAdsService.SearchStream
באמצעות שאילתה בשפת השאילתה של Google Ads, שמציינת אילו שדות להחזיר.
אחרי שמשיגים קובץ עזר של BillingSetup
, אפשר להשתמש בו כדי ליצור AccountBudgetProposal
כפי שמתואר בקטע תקציב חשבון.
ביטול של הגדרת חיוב בהמתנה
אפשר לבטל BillingSetup
שעדיין לא בתוקף באמצעות פעולת ההסרה. אפשר לבטל הגדרות חיוב רק אם הערך של status
הוא PENDING
או אם הן APPROVED
יתחילו בתאריך כלשהו בעתיד.