Method: projects.locations.userEvents.collect

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

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

בקשת HTTP


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

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

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

פרמטרים
parent

string

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

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

פרמטרים
userEvent

string

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

string

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

string (int64 format)

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

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