- בקשת HTTP
- פרמטרים של נתיב
- גוף הבקשה
- גוף התשובה
- היקפי הרשאות
- CustomerClientLinkOperation
- MutateCustomerClientLinkResult
- רוצים לנסות?
יצירה או עדכון של קישור ללקוח. הסטטוסים של הפעולות מוחזרים.
רשימת שגיאות הטמעה: AuthenticationError AuthorizationError DatabaseError FieldError FieldMaskError HeaderError InternalError ManagerLinkError MutateError NewResourceCreationError QuotaErrorRequestError
בקשת HTTP
POST https://googleads.googleapis.com/v14/customers/{customerId}/customerClientLinks:mutate
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
customerId |
חובה. המזהה של הלקוח שמתבצע שינוי בקישור ללקוח. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"operation": {
object ( |
שדות | |
---|---|
operation |
חובה. הפעולה שצריך לבצע ב-CustomerClientLink מסוים. |
validateOnly |
אם הערך הוא true, הבקשה מאומתת אבל לא מבוצעת. רק שגיאות מוחזרות, לא תוצאות. |
גוף התגובה
הודעת תגובה לשינוי של CustomerClientLink.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"result": {
object ( |
שדות | |
---|---|
result |
תוצאה שמזהה את המשאב המושפע מבקשת השינוי. |
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/adwords
למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
CustomerClientLinkOperation
פעולה יחידה (יצירה, עדכון) ב-CustomerLinkLink.
ייצוג JSON |
---|
{ "updateMask": string, // Union field |
שדות | |
---|---|
updateMask |
FieldMask שקובע אילו שדות משאבים ישונו בעדכון. זוהי רשימה של שמות שדות מלאים, שמופרדים בפסיקים. דוגמה: |
שדה איחוד operation . פעולת השינוי. הערך של operation יכול להיות רק אחת מהאפשרויות הבאות: |
|
create |
פעולת יצירה: לא נדרש שם משאב לקישור החדש. |
update |
פעולת עדכון: לקישור צריך להיות שם משאב חוקי. |
MutateCustomerClientLinkResult
התוצאה של שינוי של קישור ללקוח יחיד.
ייצוג JSON |
---|
{ "resourceName": string } |
שדות | |
---|---|
resourceName |
הוחזר בגלל פעולות שבוצעו בהצלחה. |