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

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

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