Method: customers.billingSetups.mutate

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

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

בקשת HTTP

POST https://googleads.googleapis.com/v16/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

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