הגדרת חיוב

הגדרת חיוב היא קישור ברמת החשבון בין חשבון Google Ads לבין חשבון תשלומים (שנקרא גם הגדרת חשבונית). הקישור הזה קובע למעשה מי יחויב על העלויות שהצטברו במסגרת התקציבים של החשבון שמוגדר לחיוב. כל חשבון תשלומים מתאים לחשבונית אחת.

מידע על חשבונות תשלומים

כל BillingSetup מזהה חשבון תשלומים שמקבל חשבונית על העלויות שנצברו במסגרת תקציבי החשבון שלו. חשבון התשלומים הזה משויך לפרופיל תשלומים שאחראי בסופו של דבר לחיובים.

הגדרות החיוב מכילות גם את השדה payments_account וגם קבוצה של שדות payments_account_info שמזהים את פרופיל התשלומים שנמצא בשימוש, כולל:

אם חשבון תשלומים עומד בדרישות לחיוב מאוחד, אפשר לקבץ כמה חשבונות 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 להתחיל בעתיד.

הקודם
סקירה כללית בנושא חיוב
הבא
תקציב חשבון