REST Resource: shoppingadsprogram

  • ShoppingAdsProgramStatus resource provides the status and review eligibility of your Shopping Ads program.

  • It includes global program state and region-specific statuses, covering eligibility, review issues, and onboarding requirements.

  • RegionStatus provides detailed information about program status in specific regions, including review eligibility and reasons for ineligibility.

  • If a program is ineligible for review, ReviewIneligibilityReasonDetails offer additional information like cooldown periods.

  • You can retrieve program status using the get method and request a review using the requestreview method.

Resource: ShoppingAdsProgramStatus

Response message for shoppingadsprogram.get.

JSON representation 
{
  "globalState": enum (ProgramState),
  "regionStatuses": [
    {
      object (RegionStatus)
    }
  ]
}
Fields
globalState

enum (ProgramState)

State of the program. ENABLED if there are offers for at least one region.
regionStatuses[]

object (RegionStatus)

Status of the program in each region. Regions with the same status and review eligibility are grouped together in regionCodes.

ProgramState

Different states of the program for the account.

Enums
PROGRAM_STATE_UNSPECIFIED State is unknown.
NOT_ENABLED Program is not enabled for any country.
NO_OFFERS_UPLOADED No products have been uploaded for any region. Upload products to Merchant Center.
ENABLED Program is enabled and offers are uploaded for at least one country.

RegionStatus

Status of program and region.

JSON representation 
{
  "regionCodes": [
    string
  ],
  "eligibilityStatus": enum (State),
  "reviewIssues": [
    string
  ],
  "onboardingIssues": [
    string
  ],
  "disapprovalDate": string,
  "reviewEligibilityStatus": enum (ReviewEligibility),
  "reviewIneligibilityReason": enum (ReviewIneligibilityReason),
  "reviewIneligibilityReasonDescription": string,
  "reviewIneligibilityReasonDetails": {
    object (ReviewIneligibilityReasonDetails)
  }
}
Fields
regionCodes[]

string

The two-letter ISO 3166-1 alpha-2 codes for all the regions with the same eligibilityStatus and reviewEligibility.
eligibilityStatus

enum (State)

Eligibility status of the Shopping Ads program.
reviewIssues[]

string

Issues evaluated in the review process. Fix all issues before requesting a review.
onboardingIssues[]

string

Issues that must be fixed to be eligible for review.
disapprovalDate

string

Date by which eligibilityStatus will go from WARNING to DISAPPROVED. Only visible when your eligibilityStatus is WARNING. In ISO 8601 format: YYYY-MM-DD.
reviewEligibilityStatus

enum (ReviewEligibility)

If a program is eligible for review in a specific region. Only visible if eligibilityStatus is DISAPPROVED.
reviewIneligibilityReason

enum (ReviewIneligibilityReason)

Review ineligibility reason if account is not eligible for review.
reviewIneligibilityReasonDescription

string

Reason a program in a specific region isn’t eligible for review. Only visible if reviewEligibilityStatus is INELIGIBLE.
reviewIneligibilityReasonDetails

object (ReviewIneligibilityReasonDetails)

Additional information for ineligibility. If reviewIneligibilityReason is IN_COOLDOWN_PERIOD, a timestamp for the end of the cooldown period is provided.

ReviewIneligibilityReasonDetails

Additional details for review ineligibility reasons.

JSON representation 
{
  "cooldownTime": string
}
Fields
cooldownTime

string (Timestamp format)

This timestamp represents end of cooldown period for review ineligbility reason IN_COOLDOWN_PERIOD.

Methods

get

 Retrieves the status and review eligibility for the Shopping Ads program.

requestreview

 Requests a review of Shopping ads in a specific region.