Felo API PlatformFelo API Platform
כל ה-endpoints של DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

הגדרת משימות Google Ads Search SERP

Felo API Support
MIT
שרת:https://openapi.felo.ai
ספריות לקוח
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO פעולות

הגדרת משימות Google Ads Search SERP

​

מכניס לתור את הפרסומות הפעילות מול מילת מפתח ב-Google, ומחזיר id של משימה ב-tasks[0].id. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. התאום החי עונה מיד ופשוט יותר לשאילתה בודדת; השתמשו בתור כשהקבוצה תארך יותר מקריאת כלי אחת.

מראה תמחור

  • מדידה: עלות תגובה מדווחת.
  • אומדן בקשת ייחוס: 0.02 דולר ארה״ב.
  • מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.

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

גוף
application/json
  • סוג: array (object | null)[]
    • advertiser_ids
      סוג: array string[]

      מזהי מפרסמים

      שדה חובה אם target לא צוין


      אפשר לציין עד 25 ערכים במערך הזה;

      את הערכים של advertiser_ids לפרמטר הזה אפשר למצוא בנקודת הקצה Google Ads Advertisers;

    • date_from
      סוג: string

      תאריך התחלה של טווח הזמן

      שדה אופציונלי

      שדה חובה אם צוין date_to;


      פורמט תאריך: "yyyy-mm-dd"

      ערך מזערי: 2018-05-31

      ערך מרבי: התאריך של היום

      דוגמה:

      "2020-01-01"

    • date_to
      סוג: string

      תאריך סיום של טווח הזמן

      שדה אופציונלי

      שדה חובה אם צוין date_from;


      פורמט תאריך: "yyyy-mm-dd"

      ערך מזערי: 2018-05-31

      ערך מרבי: התאריך של היום

      דוגמה:

      "2020-01-01"

    • depth
      סוג: integer | null

      עומק פענוח

      שדה אופציונלי

      מספר התוצאות ב-SERP

      ערך ברירת מחדל: 40

      ערך מרבי: 700


      החשבון שלכם יחויב עבור כל SERP המכיל עד 40 תוצאות;

      הגדרת עומק גבוה מ-40 עשויה לגרום לחיובים נוספים אם מנוע החיפוש מחזיר יותר מ-40 תוצאות;

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

    • format
      סוג: string | null

      פורמט מודעה

      שדה אופציונלי

      ערכים אפשריים: all, text, image, video

    • location_code
      סוג: integer | null

      קוד מיקום של מנוע החיפוש

      שדה אופציונלי

      אם משתמשים בשדה הזה, אין צורך לציין location_name או location_coordinate

      אפשר לקבל את רשימת המיקומים הזמינים של מנועי החיפוש עם location_code שלהם על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/serp/google/ads_search/locations

      דוגמה:

      2840


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

    • location_coordinate
      סוג: string | null

      קואורדינטות GPS של מיקום

      שדה אופציונלי

      אם משתמשים בשדה הזה, אין צורך לציין location_name או location_code

      דוגמה:

      52.6178549,-155.352142


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

    • location_name
      סוג: string | null

      השם המלא של מיקום מנוע החיפוש

      שדה אופציונלי

      אם משתמשים בשדה הזה, אין צורך לציין location_code או location_coordinate

      אפשר לקבל את רשימת המיקומים הזמינים של מנוע החיפוש עם location_name שלהם על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/serp/google/ads_search/locations

      דוגמה:

      London,England,United Kingdom


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

    • pingback_url
      סוג: string | null

      כתובת URL להתראה על השלמת משימה

      שדה אופציונלי

      כשהמשימה תושלם, נודיע לכם באמצעות בקשת GET שתישלח לכתובת ה-URL שציינתם

      אפשר להשתמש במחרוזת ‘$id’ כמשתנה $id וב-‘$tag’ כמשתנה $tag מקודד ב-urlencoded. נעדכן את הערכים הנדרשים לפני שליחת הבקשה.

      דוגמה:

      http://your-server.com/pingscript?id=$id

      http://your-server.com/pingscript?id=$id&tag=$tag

      הערה: תווים מיוחדים ב-pingback_url יקודדו ב-urlencoded;

      לדוגמה, התו # יקודד ל-%23


      מידע נוסף במרכז העזרה שלנו

    • platform
      סוג: string | null

      פלטפורמת פרסום

      שדה אופציונלי

      ערכים אפשריים: all, google_play, google_maps, google_search, google_shopping, youtube

      ערך ברירת מחדל: all

    • postback_data
      סוג: string

      סוג הנתונים של postback_url

      שדה חובה אם מציינים postback_url

      מתאים לפונקציה שבה השתמשתם להגדרת המשימה

      ערכים אפשריים:

      advanced

    • postback_url
      סוג: string | null

      כתובת URL לשליחת תוצאות המשימה

      שדה אופציונלי

      כשהמשימה תושלם, נשלח בקשת POST עם התוצאות שלה דחוסות בפורמט gzip אל ה-postback_url שציינתם

      אפשר להשתמש במחרוזת ‘$id’ כמשתנה $id וב-‘$tag’ כמשתנה $tag מקודד ב-urlencoded. נעדכן את הערכים הנדרשים לפני שליחת הבקשה.

      דוגמה:

      http://your-server.com/postbackscript?id=$id

      http://your-server.com/postbackscript?id=$id&tag=$tag

      הערה: תווים מיוחדים ב-postback_url יקודדו ב-urlencoded;

      לדוגמה, התו # יקודד ל-%23


      מידע נוסף במרכז העזרה שלנו

    • priority
      סוג: integer | null

      עדיפות משימה

      שדה אופציונלי

      יכול לקבל את הערכים הבאים:

      1 – עדיפות ביצוע רגילה (מוגדרת כברירת מחדל)

      2 – עדיפות ביצוע גבוהה


      תחויבו בתשלום נוסף עבור משימות בעדיפות ביצוע גבוהה.

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

    • tag
      סוג: string | null

      מזהה משימה שהמשתמש מגדיר

      שדה אופציונלי

      מגבלת התווים היא 255

      אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה

      תמצאו את ערך tag שצוין באובייקט data של התגובה

    • target
      סוג: string

      שם דומיין

      שדה חובה אם לא צוין advertiser_ids

      שם הדומיין המשויך לחשבון מפרסם

תגובות
  • 200
    סוג: object | null · Response36Afe1097B20_SerpGoogleAdsSearchTaskPostResponseInfo
    • cost
      סוג: number | null פורמט: double

      סך עלות המשימות, בדולר ארה״ב

    • status_code
      סוג: integer | null

      קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן

    • status_message
      סוג: string | null

      הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן

    • tasks
      סוג: array (object | null)[] | null

      מערך משימות

      • סוג: object | null · Response36Afe1097B20_SerpGoogleAdsSearchTaskPostTaskInfo
        • cost
          סוג: number | null פורמט: double

          סך עלות המשימות, בדולר ארה״ב

        • data
          סוג: object | null

          מכיל את אותם הפרמטרים שציינתם בבקשת POST

          • propertyName
            סוג: object | null
        • id
          סוג: string | null

          מזהה משימה מזהה משימה ייחודי במערכת שלנו בפורמט UUID

        • path
          סוג: array (string | null)[] | null

          נתיב URL

        • result
          סוג: object | null

          מערך תוצאות
          במקרה זה, הערך יהיה null

        • result_count
          סוג: integer | null פורמט: int64

          מספר הפריטים במערך result

        • status_code
          סוג: integer | null

          קוד הסטטוס של המשימה נוצר על ידי DataForSEO ויכול להיות בטווח הבא: 10000-60000 את הרשימה המלאה של קודי התגובה אפשר למצוא כאן

        • status_message
          סוג: string | null

          הודעה אינפורמטיבית של המשימה את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן

        • time
          סוג: string | null

          זמן ביצוע, בשניות

    • tasks_count
      סוג: integer | null פורמט: int64

      מספר המשימות במערך tasks

    • tasks_error
      סוג: integer | null פורמט: int64

      מספר המשימות במערך tasks שהוחזרו עם שגיאה

    • time
      סוג: string | null

      זמן ביצוע כולל, בשניות

    • version
      סוג: string | null

      הגרסה הנוכחית של ה-API

    application/json
  • 400

    לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.

  • 401

    נדרש מפתח API תקף של Felo.

  • 402

    לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.

  • 403

    החשבון אינו מורשה לבצע את הפעולה הזו.

  • 429

    הגעתם למגבלת בקשות או לתקרת הוצאה.

  • 502

    השירות לא הצליח להשלים את הבקשה.

  • 503

    שירות ה-API או החיוב אינו זמין באופן זמני.

  • 504

    השירות פג בזמן הטיפול בבקשה.

  • default

    תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק

    application/json
Request Example for post/v1/beta/dataforseo/serp/google/ads_search/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ads_search/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "platform": "google_search",
    "advertiser_ids": [
      "AR13752565271262920705",
      "AR02439908557932462081"
    ]
  }
]'

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": null
    }
  ]
}

פעולה מוצלחת

Setting Google Ads Search SERP Tasks