שינוי אובייקטים

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

במדריך הזה נשתמש ב-CampaignService כדי להדגים שינוי של אובייקטים מסוג Campaign, אבל אותם מושגים רלוונטיים לכל שאר השירותים הספציפיים לסוג המשאב.

שינוי אובייקטים

לכל שירות ספציפי לסוג משאב תהיה שיטת mutate שמקבלת בקשת mutate. הבקשה הזו כוללת:

• ‫customerId
• אוסף של פעולות
• הגדרה של סוג התוכן בתגובה שקובעת אם המשאב שניתן לשינוי או רק שם המשאב יוחזרו אחרי השינוי.

לדוגמה, המתודה MutateCampaigns של CampaignService מקבלת MutateCampaignsRequest שכולל:

• ‫customerId
• אוסף של CampaignOperation אובייקטים
• השדה response_content_type מציין את סוג התשובה המועדף.

תפעול

אובייקט פעולה כמו CampaignOperation מאפשר לכם לציין את הפעולה שאתם רוצים לבצע במשאב יחיד על ידי הגדרת השדה operation שלו. השדה הזה הוא oneof field שמורכב מהמאפיינים הבאים, שהסוג שלהם הוא סוג המשאב:

create

יוצרת מופע חדש של המשאב.

update

מעדכן את המשאב כך שיתאים למאפיינים של update

של ממשק ה-API של 'ניהול'. אם מגדירים את השדה הזה, צריך להגדיר גם את update_mask של הפעולה, שמציין ל-Google Ads API אילו מאפיינים לשנות במהלך פעולת העדכון. לכל ספריית לקוח יש כלי או שיטה (method) לעזרה שייצרו את update_mask בשבילכם, כמו שמוסבר בספריות הלקוח שלנו.

remove

הסרת המשאב.

השדה operation הוא שדה oneof, ולכן אי אפשר להשתמש בפעולה אחת כדי לשנות כמה אובייקטים. לדוגמה, אם רוצים ליצור קמפיין אחד ולהסיר קמפיין אחר, מוסיפים שני מופעים של CampaignOperation לבקשה: אחד עם create ואחד עם remove.

פעולות אצווה

למרות שפעולה אחת יכולה רק ליצור, לעדכן או להסיר משאב אחד, בקשת שינוי אחת יכולה להכיל כמה פעולות. מומלץ לשלב את הפעולות בבקשת שינוי אחת במקום לשלוח כמה בקשות שינוי שכל אחת מהן מכילה פעולה אחת.

לדוגמה, אם רוצים ליצור עשרה קמפיינים, צריך לשלוח בקשה אחת מסוג MutateCampaignsRequest עם עשרה אובייקטים מסוג CampaignOperation.

שינוי תשובות

מה שמוחזר בתגובה תלוי במה שנשלח בresponse_content_type של בקשת השינוי. לדוגמה, אם צוין MUTABLE_RESOURCE, אז התגובה תכיל רק את השדות שניתנים לשינוי בקמפיין. אחרי זה אפשר לבצע שינויים נוספים באובייקט המשאב הזה בלי לשחזר אותו.

שגיאות בשינוי

הפעולות בבקשת שינוי נתונה יחולו על חשבון Google Ads רק אם כל הפעולות בבקשה יצליחו. במדריך לשגיאות נפוצות מפורטת רשימה של שגיאות נפוצות והסבר איך לפתור אותן.

מעקב אחר שינויים

כדי לעקוב אחרי שינויים שבוצעו באובייקטים בחשבון Google Ads, או כדי לאחזר את המצב הנוכחי של אובייקטים, אפשר להשתמש במשאבים change_status ו-change_event.

• בדוח change_status מופיע סיכום של המשאבים שהשתנו בתקופה נתונה.
• ‫change_event מספק היסטוריה מפורטת של השינויים, כולל הערכים הישנים והחדשים של השדות ששונו.

כדי לשלוח שאילתות למשאבים האלה, משתמשים ב-method ‏GoogleAdsService.SearchStream או GoogleAdsService.Search. מידע נוסף על דיווח על סטרימינג באמצעות GoogleAdsService