Method: customers.smartCampaignSettings.getSmartCampaignStatus

מחזירה את הסטטוס של הקמפיין החכם המבוקש.

בקשת HTTP

GET https://googleads.googleapis.com/v14/{resourceName=customers/*/smartCampaignSettings/*}:getSmartCampaignStatus

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

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

פרמטרים
resourceName

string

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

גוף הבקשה

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

גוף התגובה

הודעת תשובה לגבי SmartCampaignSettingService.GetSmartCampaignStatus.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:

ייצוג JSON
{
  "smartCampaignStatus": enum (SmartCampaignStatus),

  // Union field smart_campaign_status_details can be only one of the following:
  "notEligibleDetails": {
    object (SmartCampaignNotEligibleDetails)
  },
  "eligibleDetails": {
    object (SmartCampaignEligibleDetails)
  },
  "pausedDetails": {
    object (SmartCampaignPausedDetails)
  },
  "removedDetails": {
    object (SmartCampaignRemovedDetails)
  },
  "endedDetails": {
    object (SmartCampaignEndedDetails)
  }
  // End of list of possible types for union field smart_campaign_status_details.
}
שדות
smartCampaignStatus

enum (SmartCampaignStatus)

הסטטוס של הקמפיין החכם הזה.

שדה איחוד smart_campaign_status_details. פרטים נוספים שמופיעים בסטטוס של קמפיין חכם. הערך של smart_campaign_status_details יכול להיות רק אחת מהאפשרויות הבאות:
notEligibleDetails

object (SmartCampaignNotEligibleDetails)

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

eligibleDetails

object (SmartCampaignEligibleDetails)

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

pausedDetails

object (SmartCampaignPausedDetails)

פרטים שקשורים לקמפיינים חכמים שהושהו.

removedDetails

object (SmartCampaignRemovedDetails)

פרטים שקשורים לקמפיינים חכמים שהוסרו.

endedDetails

object (SmartCampaignEndedDetails)

פרטים שקשורים לקמפיינים חכמים שהסתיימו.

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/adwords

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.

SmartCampaignStatus

סטטוסים של קמפיינים חכמים.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין הסטטוס.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתגובה בלבד.

PAUSED הקמפיין הושהה
NOT_ELIGIBLE הקמפיין לא כשיר להצגת מודעות ויש בו בעיות שעשויות לדרוש התערבות.
PENDING הקמפיין ממתין לאישור של מודעה אחת לפחות.
ELIGIBLE הקמפיין כשיר להצגה.
REMOVED הקמפיין הוסר.
ENDED הקמפיין הסתיים.

SmartCampaignNotEligibleDetails

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

ייצוג JSON
{
  "notEligibleReason": enum (SmartCampaignNotEligibleReason)
}
שדות
notEligibleReason

enum (SmartCampaignNotEligibleReason)

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

SmartCampaignNotEligibleReason

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין הסטטוס.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתגובה בלבד.

ACCOUNT_ISSUE הקמפיין לא כשיר להצגת מודעות בגלל בעיה בחשבון.
BILLING_ISSUE הקמפיין לא כשיר להצגה עקב בעיית תשלום.
BUSINESS_PROFILE_LOCATION_REMOVED המיקום של פרופיל העסק שמשויך לקמפיין הוסר.
ALL_ADS_DISAPPROVED כל המודעות שנוצרו על ידי המערכת נדחו. לקבלת פרטים נוספים, ניתן לעיין בשדה PolicySummary in the AdGroupAd.

SmartCampaignEligibleDetails

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

ייצוג JSON
{
  "lastImpressionDateTime": string,
  "endDateTime": string
}
שדות
lastImpressionDateTime

string

חותמת הזמן של החשיפה האחרונה שנצפתה ב-48 השעות האחרונות עבור הקמפיין הזה. חותמת הזמן מצוינת באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'.

endDateTime

string

חותמת הזמן של מועד הסיום של הקמפיין, אם רלוונטי. חותמת הזמן מצוינת באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'.

SmartCampaignPausedDetails

פרטים שקשורים לקמפיינים חכמים שהושהו.

ייצוג JSON
{
  "pausedDateTime": string
}
שדות
pausedDateTime

string

חותמת הזמן של המועד האחרון שבו הקמפיין הושהה. חותמת הזמן מצוינת באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'.

SmartCampaignRemovedDetails

פרטים שקשורים לקמפיינים חכמים שהוסרו.

ייצוג JSON
{
  "removedDateTime": string
}
שדות
removedDateTime

string

חותמת הזמן של מועד הסרת הקמפיין. חותמת הזמן מצוינת באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'.

SmartCampaignEndedDetails

פרטים שקשורים לקמפיינים חכמים שהסתיימו.

ייצוג JSON
{
  "endDateTime": string
}
שדות
endDateTime

string

חותמת הזמן של מועד הסיום של הקמפיין. חותמת הזמן מצוינת באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'.