Method: projects.locations.userEvents.collect

כותב אירוע משתמש יחיד מהדפדפן. הבקשה הזו משתמשת ב-GET בגלל הגבלת הדפדפן על שליחת POST לדומיין של צד שלישי.

השיטה הזו משמשת רק את פיקסל ה-JavaScript של Discovery Engine API ואת Google Tag Manager. המשתמשים לא צריכים להתקשר לשיטה הזו ישירות.

בקשת HTTP

GET https://discoveryengine.googleapis.com/v1alpha/{parent=projects/*/locations/*}/userEvents:collect

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
parent

string

חובה. שם משאב האב. אם הפעולה 'איסוף נתוני אירועים של משתמשים' מוחלת ברמה DataStore, הפורמט הוא: projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}. אם הפעולה 'איסוף אירועי משתמשים' מוחלת ברמה Location, למשל, האירוע עם Document בכמה DataStore, הפורמט הוא: projects/{project}/locations/{location}.

פרמטרים של שאילתה

פרמטרים
userEvent

string

חובה. פרוטוקול UserEvent עם קידוד כתובת URL ומגבלת אורך של 2,000,000 תווים.
uri

string

כתובת ה-URL כולל פרמטרים של CGI אבל לא כולל את מקטע הגיבוב, עם מגבלת אורך של 5,000 תווים. לרוב, המידע הזה שימושי יותר מכתובת ה-URL של הגורם המפנה, כי דפדפנים רבים שולחים רק את הדומיין לבקשות מצד שלישי.
ets

string (int64 format)

חותמת הזמן של האירוע באלפיות השנייה. כך נמנעת שמירה במטמון הדפדפן של בקשות get זהות. השם מקוצר כדי להקטין את נפח המטען הייעודי (payload) בבייט.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, התגובה היא תגובת HTTP כללית שהפורמט שלה מוגדר על ידי השיטה.

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite

ניתן למצוא מידע נוסף כאן: Authentication Overview.