תזמון העברות ב-Merchant Center

לפני שמתחילים

לפני שיוצרים העברת נתונים ב-Merchant Center:

  • מוודאים שביצעתם את כל הפעולות שנדרשות כדי להפעיל את שירות העברת נתונים ל-BigQuery.
  • יוצרים מערך נתונים ב-BigQuery לאחסון הנתונים מ-Merchant Center.
    • באזור של מערך הנתונים, אנחנו תומכים בשימוש באפשרות ברירת המחדל, 'מספר אזורים', בארה"ב או באיחוד האירופי.
    • אם רוצים ליצור מערך נתונים באזור ספציפי, העברת הנתונים ב-Merchant Center נתמכת רק באזורים הבאים:
    • us-east4 (Northern Virginia),
    • asia-northeast1 (Tokyo),
    • asia-southeast1 (Singapore),
    • australia-southeast1 (Sydney),
    • europe-north1 (Finland),
    • europe-west2 (London),
    • europe-west6 (Zurich).
  • אם אתם מתכוונים להגדיר התראות על הפעלת העברה ב-Pub/Sub, אתם צריכים הרשאות pubsub.topics.setIamPolicy. אם מגדירים רק התראות באימייל, לא צריך הרשאות Pub/Sub. מידע נוסף זמין במאמר בנושא התראות על הפעלות של שירות העברת נתונים ל-BigQuery.

ההרשאות הנדרשות

ודאו שהענקתם את ההרשאות הבאות.

התפקידים הנדרשים ב-BigQuery

כדי לקבל את ההרשאות שנדרשות ליצירת העברת נתונים באמצעות שירות העברת נתונים ל-BigQuery, צריך לבקש מהאדמין להקצות לכם את תפקיד BigQuery Admin ‏ (roles/bigquery.admin) ב-IAM בפרויקט. להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקיד המוגדר מראש הזה כולל את ההרשאות שנדרשות ליצירת העברת נתונים בשירות העברת נתונים ל-BigQuery. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:

ההרשאות הנדרשות

כדי ליצור העברת נתונים באמצעות שירות העברת הנתונים ל-BigQuery, נדרשות ההרשאות הבאות:

  • הרשאות של שירות העברת נתונים ל-BigQuery:
    • bigquery.transfers.update
    • bigquery.transfers.get
  • הרשאות ב-BigQuery:
    • bigquery.datasets.get
    • bigquery.datasets.getIamPolicy
    • bigquery.datasets.update
    • bigquery.datasets.setIamPolicy
    • bigquery.jobs.create

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

מידע נוסף מופיע במאמר בנושא מתן גישה ל-bigquery.admin.

התפקידים הנדרשים ב-Merchant Center

הגדרת העברה של חשבון Merchant Center

כדי להגדיר העברת נתונים לדיווח ב-Merchant Center, צריך:

כדי ליצור העברת נתונים לדיווח ב-Merchant Center:

המסוף

  1. עוברים לדף 'העברות נתונים' במסוף Google Cloud .

    מעבר אל "העברות נתונים"

  2. לוחצים על Create transfer (יצירת העברה).

  3. בדף Create Transfer:

    • בקטע Source type, בוחרים באפשרות Google Merchant Center בשדה Source.
    • בקטע שם הגדרת ההעברה, בשדה שם מוצג, מזינים שם להעברת הנתונים, למשל My Transfer. שם ההעברה יכול להיות כל ערך שיעזור לכם לזהות את ההעברה אם תצטרכו לשנות אותה בהמשך.

      שם ההעברה

    • בקטע אפשרויות תזמון:

      • בוחרים תדירות חזרה. אם בוחרים באפשרות שעות, ימים, שבועות או חודשים, צריך לציין גם תדירות. אפשר גם לבחור באפשרות בהתאמה אישית כדי לציין תדירות חזרה מותאמת אישית. אם בוחרים באפשרות על פי דרישה, העברת הנתונים תתבצע כשמפעילים אותה באופן ידני.
      • אם רלוונטי, בוחרים באפשרות התחלה מיידית או התחלה בשעה שנקבעה, ומזינים תאריך התחלה ומשך זמן הפעלה.
      • בשדה תאריך התחלה ושעת הפעלה, מזינים את התאריך והשעה שבהם רוצים להתחיל את ההעברה. הערך הזה צריך להיות לפחות 24 שעות אחרי השעה הנוכחית ב-UTC. אם בחרתם באפשרות Start now (אני רוצה להתחיל), האפשרות הזו מושבתת.

      אם לא משנים את אפשרויות התזמון ומשאירים את האפשרות התחלה עכשיו, ההפעלה הראשונה של העברת הנתונים מתחילה באופן מיידי ונכשלת עם הודעת השגיאה הבאה: No data to transfer found for the Merchant account. If you have just created this transfer, you may need to wait for up to a day before the data of your Merchant account are prepared and available for the transfer. ההפעלה הבאה שתוזמן אמורה לפעול בהצלחה. אם הנתונים בחשבון Merchant שלכם מוכנים באותו תאריך לפי שעון UTC, אתם יכולים להגדיר מילוי חוסרים להרצה של היום.

      לוח זמנים להעברה

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

      העברת מערך נתונים

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

      העברת נתונים מ-Google Merchant Center.

    • בתפריט Service Account בוחרים חשבון שירות מתוך חשבונות השירות שמשויכים לפרויקטGoogle Cloud . אתם יכולים לשייך חשבון שירות להעברת הנתונים במקום להשתמש בפרטי הכניסה של המשתמש. מידע נוסף על שימוש בחשבונות שירות בהעברות נתונים זמין במאמר שימוש בחשבונות שירות.

      • אם נכנסתם באמצעות זהות מאוחדת, תצטרכו חשבון שירות כדי ליצור העברת נתונים. אם נכנסתם באמצעות חשבון Google, לא חייבים להשתמש בחשבון שירות להעברה.
      • לחשבון השירות צריכות להיות ההרשאות הנדרשות.
    • (אופציונלי) בקטע אפשרויות להתראות:

      • לוחצים על המתג כדי להפעיל התראות באימייל. כשמפעילים את האפשרות הזו, האדמין של ההעברה מקבל התראה באימייל אם ההעברה נכשלת.
      • בקטע Select a Pub/Sub topic, בוחרים את שם הנושא או לוחצים על Create a topic. באמצעות האפשרות הזו מגדירים התראות על הפעלת Pub/Sub להעברה.
  4. לוחצים על Save.

BQ

מזינים את הפקודה bq mk ומספקים את האפשרות ליצירת העברה – --transfer_config. נדרשים גם הדגלים הבאים:

  • --data_source
  • --target_dataset
  • --display_name
  • --params

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

bq mk \
--transfer_config \
--project_id=project_id \
--target_dataset=dataset \
--display_name=name \
--params='parameters' \
--data_source=data_source
--service_account_name=service_account_name

כאשר:

  • project_id הוא מזהה הפרויקט.
  • dataset הוא מערך נתוני היעד להגדרת ההעברה.
  • name הוא השם המוצג של הגדרת ההעברה. שם ההעברה יכול להיות כל ערך שיאפשר לכם לזהות את ההעברה אם תצטרכו לשנות אותה בהמשך.
  • parameters מכיל את הפרמטרים של הגדרת ההעברה שנוצרה בפורמט JSON. לדוגמה: --params='{"param":"param_value"}'.
    • כדי להעביר נתונים מ-Merchant Center, צריך לספק את הפרמטר merchant_id.
    • הפרמטר export_products מציין אם להעביר נתוני מוצרים ובעיות במוצרים. הפרמטר הזה נכלל כברירת מחדל, גם אם לא מציינים את הפרמטר export_products. ‫Google ממליצה לכלול את הפרמטר הזה באופן מפורש ולהגדיר אותו לערך true.
    • הפרמטר export_regional_inventories מציין אם להעביר נתוני מלאי אזוריים.
    • הפרמטר export_local_inventories מציין אם להעביר נתוני מלאי בחנות מקומית.
    • הפרמטר export_price_competitiveness מציין אם להעביר נתונים של השוואת מחירים ביחס לשוק.
    • הפרמטר export_price_insights מציין אם להעביר את נתוני מדדי המחירים.
    • הפרמטר export_best_sellers_v2 מציין אם להעביר נתונים של המוצרים הכי נמכרים.
    • הפרמטר export_performance מציין אם להעביר נתוני ביצועים של מוצרים.
  • data_source הוא מקור הנתונים – merchant_center.
  • service_account_name הוא שם חשבון השירות שמשמש לאימות העברת הנתונים. חשבון השירות צריך להיות בבעלות אותו project_id ששימש ליצירת ההעברה, וצריכות להיות לו כל ההרשאות הנדרשות.

לדוגמה, הפקודה הבאה יוצרת העברת נתונים של Merchant Center בשם My Transfer באמצעות מספר חשבון Merchant 1234 וערכת נתונים של יעד mydataset. העברת הנתונים נוצרת בפרויקט שמוגדר כברירת מחדל.

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--params='{"merchant_id":"1234","export_products":"true","export_regional_inventories":"true","export_local_inventories":"true","export_price_benchmarks":"true","export_best_sellers":"true"}' \
--data_source=merchant_center

בפעם הראשונה שמריצים את הפקודה, מקבלים הודעה כמו זו:

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

פועלים לפי ההוראות בהודעה ומדביקים את קוד האימות בשורת הפקודה.

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

API

משתמשים בשיטה projects.locations.transferConfigs.create ומספקים מופע של המשאב TransferConfig.

פתרון בעיות בהגדרת העברה של חשבון Merchant Center

אם נתקלתם בבעיות בהגדרת העברת הנתונים, אפשר לעיין במאמר פתרון בעיות בהגדרת העברת נתונים בשירות העברת נתונים ל-BigQuery, בקטע בעיות בהעברת נתונים ב-Merchant Center.