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
}
Fields
topic

string

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

mustFix

boolean

Required. Indicates if this is a policy violation or not. When the value is true, issues that are instances of this topic must be addressed to remain in compliance with the partner's agreements with Google. A false value indicates that it's not mandatory to fix the issues but advertising demand might be restricted.

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.