Method: customers.billingSetups.mutate

יצירה של הגדרת חיוב או ביטול של הגדרת חיוב קיימת.

רשימת שגיאות התרעה: AuthenticationError AuthorizationError BillingSetupError DateError FieldError HeaderError InternalError MutateError QuotaError RequestError

בקשת HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}/billingSetups:mutate

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
customerId

string

חובה. מזהה הלקוח שעליו יש להחיל את פעולת השינוי של הגדרת החיוב.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "operation": {
    object (BillingSetupOperation)
  }
}
שדות
operation

object (BillingSetupOperation)

חובה. הפעולה שצריך לבצע.

גוף התגובה

הודעת תגובה לפעולה של הגדרת חיוב.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:

ייצוג JSON 
{
  "result": {
    object (MutateBillingSetupResult)
  }
}
שדות
result

object (MutateBillingSetupResult)

תוצאה שמזהה את המשאב המושפע מבקשת השינוי.

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/adwords

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.

BillingSetupOperation

פעולה יחידה בהגדרת חיוב, שמתארת את הביטול של הגדרת חיוב קיימת.

ייצוג JSON 
{

  // Union field operation can be only one of the following:
  "create": {
    object (BillingSetup)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
שדות
שדה איחוד operation. אפשר להגדיר רק אחת מהפעולות האלה. אין תמיכה בפעולות 'עדכון'. הערך של operation יכול להיות רק אחת מהאפשרויות הבאות:
create

object (BillingSetup)

יצירה של הגדרת חיוב. לא נדרש שם למשאב להגדרת החיוב החדשה.
remove

string

שם המשאב של הגדרת החיוב שיש להסיר. אי אפשר להסיר הגדרה, אלא אם היא במצב המתנה או ששעת ההתחלה המתוזמנת שלה היא בעתיד. שם המשאב נראה כך: customers/{customerId}/billingSetups/{billing_id}.

MutateBillingSetupResult

תוצאה של שינוי אחד לגבי הגדרת חיוב.

ייצוג JSON 
{
  "resourceName": string
}
שדות
resourceName

string

הוחזר בגלל פעולות שבוצעו בהצלחה.