כדאי להירשם עוד היום לאירוע בנושא קמפיינים למיקסום ביצועים ולסדנת Google Ads API, שיתקיים ב-17 ביולי.

דף זה תורגם על ידי Cloud Translation API.

הגדרת חיוב

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

סקירה כללית

תקציב חשבון