הגדרת חיוב

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

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

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

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

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