הגדרת החיוב היא קישור ברמת החשבון בין חשבון Google Ads לבין חשבון Google Payments (נקרא גם חשבונית) ), קובע מי יחויב בעלויות שהצטברו בחשבון של הגדרת החיוב תקציבים. כל חשבון תשלומים מקביל לחשבונית אחת.
מידע על חשבונות תשלומים
כל BillingSetup
מזהה חשבון תשלומים
שמחויב בחשבונית על עלויות שנובעות מתקציבי החשבון שלו. התשלום הזה
משויך לפרופיל Google Payments
פרופיל, שבסופו של דבר
האחראים על החיובים.
הגדרות החיוב כוללות גם 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 אפשר לקבץ חשבונות Google Ads באותה חשבונית על ידי הגדרה של הגדרות החיוב שלהם להשתמש באותו חשבון תשלומים בסיסי.
יצירה של הגדרות חיוב חדשות
אפשר לקשר הגדרות חיוב חדשות לחשבונות תשלומים קיימים או לחשבונות שנוצרו בו-זמנית.
באמצעות חשבון תשלומים קיים
כדי לקשר לחשבון תשלומים קיים, צריך להגדיר
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 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
כדי להתחיל זמן מה בעתיד.