PolicyTopicEntry

ממצא של הפרת מדיניות שמצורף למשאב (לדוגמה, מדיניות בנושא אלכוהול שמשויכת לאתר שמוכר אלכוהול).

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

ייצוג ב-JSON
{
  "type": enum (PolicyTopicEntryType),
  "evidences": [
    {
      object (PolicyTopicEvidence)
    }
  ],
  "constraints": [
    {
      object (PolicyTopicConstraint)
    }
  ],
  "topic": string
}
שדות
type

enum (PolicyTopicEntryType)

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

evidences[]

object (PolicyTopicEvidence)

מידע נוסף שמסביר את מציאת המדיניות (לדוגמה, שם המותג לזיהוי סימן מסחרי).

constraints[]

object (PolicyTopicConstraint)

מציין איך הצגת המשאב הזה עשויה להיות מושפעת (לדוגמה, לא מוצג במדינה).

topic

string

נושא המדיניות שאליו מתייחס הממצא. לדוגמה, 'ALCOHOL',‏ 'TRADEMARKS_IN_AD_TEXT' או 'DESTINATION_NOT_WORKING'. קבוצת הנושאים האפשריים של המדיניות לא קבועה לגרסה מסוימת של API, וניתן לשנות אותה בכל שלב.

PolicyTopicEntryType

סוגי הרשומות האפשריים בנושאי המדיניות.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN

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

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

PROHIBITED המשאב לא יוצג.
LIMITED המשאב לא יוצג בנסיבות מסוימות.
FULLY_LIMITED לא ניתן להציג את המשאב בכלל בגלל קריטריוני הטירגוט הנוכחיים.
DESCRIPTIVE יכול להיות שהם מעניינים, אבל הם לא מגבילים את אופן הצגת המשאב.
BROADENING עשויה להגדיל את הכיסוי מעבר לרגיל.
AREA_OF_INTEREST_ONLY מוגבלת בכל המדינות שמוגדרות לטירגוט, אבל יכולה להופיע במדינות אחרות באמצעות טירגוט לפי תחום עניין.

PolicyTopicEvidence

מידע נוסף שמסביר את ממצאי המדיניות.

ייצוג ב-JSON
{

  // Union field value can be only one of the following:
  "websiteList": {
    object (WebsiteList)
  },
  "textList": {
    object (TextList)
  },
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  }
  // End of list of possible types for union field value.
}
שדות
שדה איחוד value. פרטי הוכחה ספציפיים בהתאם לסוג ההוכחה. הערך של value יכול להיות רק אחת מהאפשרויות הבאות:
websiteList

object (WebsiteList)

רשימה של אתרים שמקושרים למשאב הזה.

textList

object (TextList)

רשימת הראיות שנמצאו בטקסט של משאב.

languageCode

string

השפה שבה זוהה שהמשאב נכתב. זהו תג שפה של IETF, כמו 'en-US'.

destinationTextList

object (DestinationTextList)

הטקסט ביעד של המשאב שמוביל לממצאי מדיניות.

destinationMismatch

object (DestinationMismatch)

חוסר התאמה בין היעדים של כתובות ה-URL של המשאב.

destinationNotWorking

object (DestinationNotWorking)

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

WebsiteList

רשימה של האתרים שגרמו למציאת מדיניות. לדוגמה, משמש לנושא המדיניות ONE_WEBSITE_PER_AD_GROUP. אם יש יותר מחמישה אתרים, רק חמשת האתרים המובילים (אלה שמופיעים הכי הרבה במשאבים) יופיעו כאן.

ייצוג JSON
{
  "websites": [
    string
  ]
}
שדות
websites[]

string

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

TextList

רשימה של קטעי טקסט שהפרו מדיניות.

ייצוג ב-JSON
{
  "texts": [
    string
  ]
}
שדות
texts[]

string

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

DestinationTextList

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

ייצוג ב-JSON
{
  "destinationTexts": [
    string
  ]
}
שדות
destinationTexts[]

string

רשימת הטקסט שנמצא בדף היעד של המשאב.

DestinationMismatch

הוכחה לחוסר התאמה בין כתובות ה-URL של משאב.

ייצוג ב-JSON
{
  "urlTypes": [
    enum (PolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
שדות
urlTypes[]

enum (PolicyTopicEvidenceDestinationMismatchUrlType)

הקבוצה של כתובות ה-URL שלא תואמות זו לזו.

PolicyTopicEvidenceDestinationMismatchUrlType

סוגי כתובות ה-URL האפשריים של הנושא 'חוסר התאמה בין המודעות ליעדיהן'.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN

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

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

DISPLAY_URL כתובת ה-URL לתצוגה.
FINAL_URL כתובת ה-URL הסופית.
FINAL_MOBILE_URL כתובת ה-URL הסופית לנייד.
TRACKING_URL תבנית כתובת ה-URL למעקב, עם כתובת URL שהוחלפה למחשב.
MOBILE_TRACKING_URL תבנית כתובת ה-URL למעקב, עם כתובת URL חלופית לנייד.

DestinationNotWorking

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

ייצוג ב-JSON
{
  "device": enum (PolicyTopicEvidenceDestinationNotWorkingDevice),
  "expandedUrl": string,
  "lastCheckedDateTime": string,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
שדות
device

enum (PolicyTopicEvidenceDestinationNotWorkingDevice)

סוג המכשיר שבו נכשלה טעינת כתובת ה-URL.

expandedUrl

string

כתובת ה-URL המלאה שלא פעלה.

lastCheckedDateTime

string

המועד האחרון שבו נבדקה כתובת ה-URL. הפורמט הוא 'YYYY-MM-DD HH:MM:SS'. דוגמאות: ‎"2018-03-05 09:15:00" או "2018-02-01 14:34:30"‎

שדה האיחוד reason. מציין את הסיבה למציאת המדיניות בנושא DESTINATION_NOT_WORKING. הערך של reason יכול להיות רק אחת מהאפשרויות הבאות:
dnsErrorType

enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

הסוג של שגיאת ה-DNS.

httpErrorCode

string (int64 format)

קוד השגיאה של HTTP.

PolicyTopicEvidenceDestinationNotWorkingDevice

נושא המדיניות האפשרי הוא 'עדות למכשירים עם יעד שאינו פועל'.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN

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

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

DESKTOP דף הנחיתה לא פועל במחשב.
ANDROID דף הנחיתה לא פועל במכשירי Android.
IOS דף הנחיתה לא פועל במכשיר iOS.

PolicyTopicEvidenceDestinationNotWorkingDnsErrorType

הנושאים האפשריים בנושא המדיניות מתייחסים לסוגים של שגיאות DNS שקשורות ליעד שאינו פועל.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN

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

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

HOSTNAME_NOT_FOUND שם המארח לא נמצא ב-DNS בזמן אחזור דף הנחיתה.
GOOGLE_CRAWLER_DNS_ISSUE בעיה בסורק הפנימי של Google בתקשורת עם DNS. השגיאה הזו לא מעידה על כך שדף הנחיתה לא פועל. Google תסרוק מחדש את דף הנחיתה.

PolicyTopicConstraint

תיאור ההשפעה של הרשאה בנושא מדיניות על הצגת המודעות.

ייצוג ב-JSON
{

  // Union field value can be only one of the following:
  "countryConstraintList": {
    object (CountryConstraintList)
  },
  "resellerConstraint": {
    object (ResellerConstraint)
  },
  "certificateMissingInCountryList": {
    object (CountryConstraintList)
  },
  "certificateDomainMismatchInCountryList": {
    object (CountryConstraintList)
  }
  // End of list of possible types for union field value.
}
שדות
שדה איחוד value. מידע ספציפי על האילוץ. הערך של value יכול להיות רק אחת מהאפשרויות הבאות:
countryConstraintList

object (CountryConstraintList)

המדינות שבהן המשאב לא יכול להופיע.

resellerConstraint

object (ResellerConstraint)

מגבלת מפיץ.

certificateMissingInCountryList

object (CountryConstraintList)

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

certificateDomainMismatchInCountryList

object (CountryConstraintList)

מדינות שבהן הדומיין של המשאב לא מכוסה באישורים שמשויכים אליו.

CountryConstraintList

רשימה של המדינות שבהן הצגת המשאב מוגבלת.

ייצוג JSON
{
  "countries": [
    {
      object (CountryConstraint)
    }
  ],
  "totalTargetedCountries": integer
}
שדות
countries[]

object (CountryConstraint)

המדינות שבהן הצגת המודעות מוגבלת.

totalTargetedCountries

integer

המספר הכולל של המדינות שמוגדרות כמדינות יעד של המשאב.

CountryConstraint

מציין שהיכולת של משאב להציג מודעות במדינה מסוימת מוגבלת.

ייצוג ב-JSON
{
  "countryCriterion": string
}
שדות
countryCriterion

string

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

ResellerConstraint

אין שדות לסוג הזה.

המשמעות של הערך הזה היא שנושא מדיניות הוגבל בגלל דחייה של האתר למטרות של מפיץ.