REST Resource: accounts.policyIssues

Resource: PolicyIssue

Representation of a policy issue for a single entity (site, site-section, or page). All issues for a single entity are represented by a single PolicyIssue resource, though that PolicyIssue can have multiple causes (or "topics") that can change over time. Policy issues are removed if there are no issues detected recently or if there's a recent successful appeal for the entity.

JSON representation
{
  "name": string,
  "entityType": enum (EntityType),
  "site": string,
  "siteSection": string,
  "uri": string,
  "adClients": [
    string
  ],
  "policyTopics": [
    {
      object (PolicyTopic)
    }
  ],
  "adRequestCount": string,
  "action": enum (EnforcementAction),
  "firstDetectedDate": {
    object (Date)
  },
  "lastDetectedDate": {
    object (Date)
  },
  "warningEscalationDate": {
    object (Date)
  }
}
Fields
name

string

Required. Resource name of the entity with policy issues. Format: accounts/{account}/policyIssues/{policy_issue}

entityType

enum (EntityType)

Required. Type of the entity indicating if the entity is a site, site-section, or page.

site

string

Required. Hostname/domain of the entity (for example "foo.com" or "www.foo.com"). This should be a bare domain/host name without any protocol. This will be present for all policy issues.

siteSection

string

Optional. Prefix of the site-section having policy issues (For example "foo.com/bar-section"). This will be present if the entityType is SITE_SECTION and will be absent for other entity types.

uri

string

Optional. URI of the page having policy violations (for example "foo.com/bar" or "www.foo.com/bar"). This will be present if the entityType is PAGE and will be absent for other entity types.

adClients[]

string

Optional. List of ad clients associated with the policy issue (either as the primary ad client or an associated host/secondary ad client). In the latter case, this will be an ad client that is not owned by the current account.

policyTopics[]

object (PolicyTopic)

Required. Unordered list. The policy topics that this entity was found to violate over the past seven days.

adRequestCount

string (int64 format)

Required. Total number of ad requests affected by the policy violations over the past seven days.

action

enum (EnforcementAction)

Required. The most severe action taken on the entity over the past seven days.

firstDetectedDate

object (Date)

Required. The date (in the America/Los_Angeles timezone) when policy violations were first detected on the entity.

lastDetectedDate

object (Date)

Required. The date (in the America/Los_Angeles timezone) when policy violations were last detected on the entity.

warningEscalationDate

object (Date)

Optional. The date (in the America/Los_Angeles timezone) when the entity will have ad serving demand restricted or ad serving disabled. This is present only for issues with a WARNED enforcement action. See https://support.google.com/adsense/answer/11066888.

EntityType

Type of an entity.

Enums
ENTITY_TYPE_UNSPECIFIED The entity type is unspecified.
SITE The enforced entity is an entire website.
SITE_SECTION The enforced entity is a particular section of a website. All the pages with this prefix are enforced.
PAGE The enforced entity is a single web page.

PolicyTopic

Information about a particular policy topic. A policy topic represents a single class of policy issue that can impact ad serving for your site. For example, sexual content or having ads that obscure your content. A single policy issue can have multiple policy topics for a single entity.

JSON representation
{
  "topic": string,
  "mustFix": boolean,
  "type": enum (PolicyTopicType)
}
Fields
topic

string

Required. The policy topic. For example, "sexual-content" or "ads-obscuring-content"."

mustFix
(deprecated)

boolean

Required. Deprecated. Policy topics no longer have a "must-fix" classification.

type

enum (PolicyTopicType)

Optional. The type of policy topic. For example, "POLICY" represents all the policy topics that are related to the Google Publisher Policy (GPP). See https://support.google.com/adsense/answer/15689616.

PolicyTopicType

The type of policy topic. For example, "POLICY" represents all the policy topics that are related to the Google Publisher Policy (GPP). See https://support.google.com/adsense/answer/15689616.

Enums
POLICY_TOPIC_TYPE_UNSPECIFIED The type is unspecified.
POLICY Topics that are primarily related to the Google Publisher Policy (GPP) https://support.google.com/publisherpolicies/answer/10502938 or the Google Publisher Restrictions (GPR) policies https://support.google.com/publisherpolicies/answer/10437795.
ADVERTISER_PREFERENCE Topics that are related to advertiser preferences. Certain advertisers may choose not to bid on content that are labeled with certain policies.
REGULATORY Any topics that are a result of a country or regional regulatory requirement body.

EnforcementAction

Policy enforcement action taken on the entity. See https://support.google.com/adsense/answer/11066888.

Enums
ENFORCEMENT_ACTION_UNSPECIFIED The action is unspecified.
WARNED No ad serving enforcement is currently present, but enforcement will start on the warningEscalationDate if the issue is not resolved.
AD_SERVING_RESTRICTED Ad serving demand has been restricted on the entity.
AD_SERVING_DISABLED Ad serving has been disabled on the entity.
AD_SERVED_WITH_CLICK_CONFIRMATION Ads are being served for the entity but Confirmed Click is being applied to the ads. See https://support.google.com/adsense/answer/10025624.
AD_PERSONALIZATION_RESTRICTED Ad personalization is restricted because the ad requests coming from the EEA and UK do not have a TCF string or the Consent Management Platform (CMP) indicated by the TCF string is not Google certified. As a result, basic/limited ads will be served. See https://support.google.com/adsense/answer/13554116

Methods

get

Gets information about the selected policy issue.

list

Lists all the policy issues where the specified account is involved, both directly and through any AFP child accounts.