# Content API for Shopping . freelistingsprogram

## Instance Methods

Close httplib2 connections.

Retrieves the status and review eligibility for the free listing program.

Requests a review of free listings in a specific region. This method is only available to selected merchants.

### Method Details

`close()`

    Close httplib2 connections.

`get(merchantId, x__xgafv=None)`

    Retrieves the status and review eligibility for the free listing program.

    Args:
      merchantId: string, Required. The ID of the account. (required)
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # Response message for GetFreeListingsProgramStatus.
      "globalState": "A String", # State of the program. `ENABLED` if there are offers for at least one region.
      "regionStatuses": [ # Status of the program in each region. Regions with the same status and review eligibility are grouped together in `regionCodes`.
        { # Status of program and region.
          "disapprovalDate": "A String", # Date by which eligibilityStatus will go from `WARNING` to `DISAPPROVED`. Only visible when your eligibilityStatus is WARNING. In [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DD`.
          "eligibilityStatus": "A String", # Eligibility status of the standard free listing program.
          "onboardingIssues": [ # Issues that must be fixed to be eligible for review.
            "A String",
          ],
          "regionCodes": [ # The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) codes for all the regions with the same `eligibilityStatus` and `reviewEligibility`.
            "A String",
          ],
          "reviewEligibilityStatus": "A String", # If a program is eligible for review in a specific region. Only visible if `eligibilityStatus` is `DISAPPROVED`.
          "reviewIneligibilityReason": "A String", # Review ineligibility reason if account is not eligible for review.
          "reviewIneligibilityReasonDescription": "A String", # Reason a program in a specific region isn’t eligible for review. Only visible if `reviewEligibilityStatus` is `INELIGIBLE`.
          "reviewIneligibilityReasonDetails": { # Additional details for review ineligibility reasons. # Additional information for ineligibility. If `reviewIneligibilityReason` is `IN_COOLDOWN_PERIOD`, a timestamp for the end of the cooldown period is provided.
            "cooldownTime": "A String", # This timestamp represents end of cooldown period for review ineligbility reason `IN_COOLDOWN_PERIOD`.
          },
          "reviewIssues": [ # Issues evaluated in the review process. Fix all issues before requesting a review.
            "A String",
          ],
        },
      ],
    }

`requestreview(merchantId, body=None, x__xgafv=None)`

    Requests a review of free listings in a specific region. This method is only available to selected merchants.

    Args:
      merchantId: string, Required. The ID of the account. (required)
      body: object, The request body.
        The object takes the form of:

    { # Request message for the RequestReviewFreeListings Program method.
      "regionCode": "A String", # The code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the country for which review is to be requested.
    }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format