יוצר, מעדכן או מסיר מודעות. מוחזרים סטטוסים של פעולות.
AdCustomizerErrorAdErrorAdGroupAdErrorAdSharingErrorAdxErrorAssetErrorAssetLinkErrorAuthenticationErrorAuthorizationErrorCollectionSizeErrorContextErrorDatabaseErrorDateErrorDistinctErrorFeedAttributeReferenceErrorFieldErrorFieldMaskErrorFunctionErrorFunctionParsingErrorHeaderErrorIdErrorImageErrorInternalErrorListOperationErrorMediaBundleErrorMediaFileErrorMutateErrorNewResourceCreationErrorNotEmptyErrorNullErrorOperationAccessDeniedErrorOperatorErrorPolicyFindingErrorPolicyValidationParameterErrorPolicyViolationErrorQuotaErrorRangeErrorRequestErrorResourceCountLimitExceededErrorSizeLimitErrorStringFormatErrorStringLengthErrorUrlFieldError
בקשת HTTP
POST https://googleads.googleapis.com/v17/customers/{customerId}/adGroupAds:mutate
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
customerId |
חובה. המזהה של הלקוח שהמודעות שלו שונו. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "operations": [ { object ( |
שדות | |
---|---|
operations[] |
חובה. רשימת הפעולות שצריך לבצע במודעות בודדות. |
partialFailure |
אם הערך הוא True, פעולות יבוצעו בהצלחה ופעולות לא חוקיות יחזירו שגיאות. אם הערך הוא False, כל הפעולות יבוצעו בעסקה אחת רק אם הן חוקיות. ברירת המחדל היא False. |
validateOnly |
אם True, הבקשה מאומתת אבל לא מבוצעת. מוצגות רק שגיאות, ולא תוצאות. |
responseContentType |
הגדרת סוג התוכן של התשובה. המדיניות קובעת אם צריך להחזיר את המשאב שניתן לשינוי או רק את שם המשאב אחרי המוטציה. |
גוף התשובה
הודעת תגובה לשינוי מודעה בקבוצת מודעות.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "partialFailureError": { object ( |
שדות | |
---|---|
partialFailureError |
שגיאות שנוגעות לכשלים בפעולה במצב 'כשל חלקי'. מוחזר רק כאשרpartFailure = true וכל השגיאות מתרחשות בתוך הפעולות. אם מתרחשות שגיאות מחוץ לפעולות (לדוגמה, שגיאות אימות), אנחנו מחזירים שגיאה ברמת ה-RPC. |
results[] |
כל התוצאות של השינוי. |
היקפי ההרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/adwords
למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.