Content API for Shopping . buyongoogleprograms

Instance Methods

activate(merchantId, regionCode, body=None, x__xgafv=None)

Reactivates the BoG program in your Merchant Center account. Moves the program to the active state when allowed, e.g. when paused. Important: This method is only whitelisted for selected merchants.

close()

Close httplib2 connections.

get(merchantId, regionCode, x__xgafv=None)

Retrieves a status of the BoG program for your Merchant Center account.

onboard(merchantId, regionCode, body=None, x__xgafv=None)

Onboards the BoG program in your Merchant Center account. By using this method, you agree to the [Terms of Service](https://merchants.google.com/mc/termsofservice/transactions/US/latest). Calling this method is only possible if the authenticated account is the same as the merchant id in the request. Calling this method multiple times will only accept Terms of Service if the latest version is not currently signed.

patch(merchantId, regionCode, body=None, updateMask=None, x__xgafv=None)

Updates the status of the BoG program for your Merchant Center account.

pause(merchantId, regionCode, body=None, x__xgafv=None)

Pauses the BoG program in your Merchant Center account. Important: This method is only whitelisted for selected merchants.

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

Requests review and then activates the BoG program in your Merchant Center account for the first time. Moves the program to the REVIEW_PENDING state. Important: This method is only whitelisted for selected merchants.

Method Details

activate(merchantId, regionCode, body=None, x__xgafv=None)
Reactivates the BoG program in your Merchant Center account. Moves the program to the active state when allowed, e.g. when paused. Important: This method is only whitelisted for selected merchants.

Args:
  merchantId: string, Required. The ID of the account. (required)
  regionCode: string, Required. The program region code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Currently only US is available. (required)
  body: object, The request body.
    The object takes the form of:

{ # Request message for the ActivateProgram method.
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format
close()
Close httplib2 connections.
get(merchantId, regionCode, x__xgafv=None)
Retrieves a status of the BoG program for your Merchant Center account.

Args:
  merchantId: string, Required. The ID of the account. (required)
  regionCode: string, Required. The Program region code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Currently only US is available. (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 the GetProgramStatus method.
  "businessModel": [ # The business models in which merchant participates.
    "A String",
  ],
  "customerServicePendingEmail": "A String", # The customer service pending email. After verification this field becomes empty.
  "customerServicePendingPhoneNumber": "A String", # The pending phone number specified for BuyOnGoogle program. It might be different than account level phone number. In order to update this field the customer_service_pending_phone_region_code must also be set. After verification this field becomes empty.
  "customerServicePendingPhoneRegionCode": "A String", # Two letter country code for the pending phone number, for example `CA` for Canadian numbers. See the [ISO 3166-1 alpha-2](https://wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) officially assigned codes. In order to update this field the customer_service_pending_phone_number must also be set. After verification this field becomes empty.
  "customerServiceVerifiedEmail": "A String", # Output only. The customer service verified email.
  "customerServiceVerifiedPhoneNumber": "A String", # Output only. The verified phone number specified for BuyOnGoogle program. It might be different than account level phone number.
  "customerServiceVerifiedPhoneRegionCode": "A String", # Output only. Two letter country code for the verified phone number, for example `CA` for Canadian numbers. See the [ISO 3166-1 alpha-2](https://wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) officially assigned codes.
  "onlineSalesChannel": "A String", # The channels through which the merchant is selling.
  "participationStage": "A String", # Output only. The current participation stage for the program.
}
onboard(merchantId, regionCode, body=None, x__xgafv=None)
Onboards the BoG program in your Merchant Center account. By using this method, you agree to the [Terms of Service](https://merchants.google.com/mc/termsofservice/transactions/US/latest). Calling this method is only possible if the authenticated account is the same as the merchant id in the request. Calling this method multiple times will only accept Terms of Service if the latest version is not currently signed.

Args:
  merchantId: string, Required. The ID of the account. (required)
  regionCode: string, Required. The program region code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Currently only US is available. (required)
  body: object, The request body.
    The object takes the form of:

{ # Request message for the OnboardProgram method.
  "customerServiceEmail": "A String", # The customer service email.
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format
patch(merchantId, regionCode, body=None, updateMask=None, x__xgafv=None)
Updates the status of the BoG program for your Merchant Center account.

Args:
  merchantId: string, Required. The ID of the account. (required)
  regionCode: string, Required. The program region code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Currently only US is available. (required)
  body: object, The request body.
    The object takes the form of:

{ # Response message for the GetProgramStatus method.
  "businessModel": [ # The business models in which merchant participates.
    "A String",
  ],
  "customerServicePendingEmail": "A String", # The customer service pending email. After verification this field becomes empty.
  "customerServicePendingPhoneNumber": "A String", # The pending phone number specified for BuyOnGoogle program. It might be different than account level phone number. In order to update this field the customer_service_pending_phone_region_code must also be set. After verification this field becomes empty.
  "customerServicePendingPhoneRegionCode": "A String", # Two letter country code for the pending phone number, for example `CA` for Canadian numbers. See the [ISO 3166-1 alpha-2](https://wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) officially assigned codes. In order to update this field the customer_service_pending_phone_number must also be set. After verification this field becomes empty.
  "customerServiceVerifiedEmail": "A String", # Output only. The customer service verified email.
  "customerServiceVerifiedPhoneNumber": "A String", # Output only. The verified phone number specified for BuyOnGoogle program. It might be different than account level phone number.
  "customerServiceVerifiedPhoneRegionCode": "A String", # Output only. Two letter country code for the verified phone number, for example `CA` for Canadian numbers. See the [ISO 3166-1 alpha-2](https://wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) officially assigned codes.
  "onlineSalesChannel": "A String", # The channels through which the merchant is selling.
  "participationStage": "A String", # Output only. The current participation stage for the program.
}

  updateMask: string, The list of fields to update. If the update mask is not provided, then all the fields set in buyOnGoogleProgramStatus will be updated. Clearing fields is only possible if update mask is provided.
  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 the GetProgramStatus method.
  "businessModel": [ # The business models in which merchant participates.
    "A String",
  ],
  "customerServicePendingEmail": "A String", # The customer service pending email. After verification this field becomes empty.
  "customerServicePendingPhoneNumber": "A String", # The pending phone number specified for BuyOnGoogle program. It might be different than account level phone number. In order to update this field the customer_service_pending_phone_region_code must also be set. After verification this field becomes empty.
  "customerServicePendingPhoneRegionCode": "A String", # Two letter country code for the pending phone number, for example `CA` for Canadian numbers. See the [ISO 3166-1 alpha-2](https://wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) officially assigned codes. In order to update this field the customer_service_pending_phone_number must also be set. After verification this field becomes empty.
  "customerServiceVerifiedEmail": "A String", # Output only. The customer service verified email.
  "customerServiceVerifiedPhoneNumber": "A String", # Output only. The verified phone number specified for BuyOnGoogle program. It might be different than account level phone number.
  "customerServiceVerifiedPhoneRegionCode": "A String", # Output only. Two letter country code for the verified phone number, for example `CA` for Canadian numbers. See the [ISO 3166-1 alpha-2](https://wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) officially assigned codes.
  "onlineSalesChannel": "A String", # The channels through which the merchant is selling.
  "participationStage": "A String", # Output only. The current participation stage for the program.
}
pause(merchantId, regionCode, body=None, x__xgafv=None)
Pauses the BoG program in your Merchant Center account. Important: This method is only whitelisted for selected merchants.

Args:
  merchantId: string, Required. The ID of the account. (required)
  regionCode: string, Required. The program region code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Currently only US is available. (required)
  body: object, The request body.
    The object takes the form of:

{ # Request message for the PauseProgram method.
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format
requestreview(merchantId, regionCode, body=None, x__xgafv=None)
Requests review and then activates the BoG program in your Merchant Center account for the first time. Moves the program to the REVIEW_PENDING state. Important: This method is only whitelisted for selected merchants.

Args:
  merchantId: string, Required. The ID of the account. (required)
  regionCode: string, Required. The program region code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Currently only US is available. (required)
  body: object, The request body.
    The object takes the form of:

{ # Request message for the RequestReviewProgram method.
}

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