הגדרת חיוב

הגדרת חיוב היא קישור ברמת החשבון בין חשבון 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 להתחיל בעתיד.

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