organizations

Changed on

Creates a publication.

post/v1/{+parent}/publications

Request

  • Base URL: https://webcontentpublisher.googleapis.com
  • URL: https://webcontentpublisher.googleapis.com/v1/{+parent}/publications
  • Auth: OAuth 2 (implicit, authorization URL https://accounts.google.com/o/oauth2/auth, scopes: https://www.googleapis.com/auth/webcontentpublisher.publications.manage.system) and OAuth 2 (authorization code, authorization URL https://accounts.google.com/o/oauth2/auth, token URL https://accounts.google.com/o/oauth2/token, scopes: https://www.googleapis.com/auth/webcontentpublisher.publications.manage.system)

Path parameters

parentstring required

Required. The parent resource where this publication will be created. Format: organizations/{organization}.

Query parameters

publicationIdstring

Optional. The unique identifier of the publication to create. If not specified, the server will generate a random publication ID.

Request body

displayNamestring

Required. The user-visible display name of the publication.

languageCodestring

Required. The primary language of the publication (BCP-47 code, e.g., "en-US").

namestring

Identifier. The resource name of the publication. Format: organizations/{organization}/publications/{publication}

onboardingState'ONBOARDING_STATE_UNSPECIFIED' | 'ACTION_REQUIRED' | 'PENDING_VERIFICATION' | 'COMPLETE'

Output only. The current onboarding state.

organizationIdstring

Output only. The unique identifier of the organization that owns this publication.

paymentOption'PAYMENT_OPTION_UNSPECIFIED' | 'NONE' | 'SUBSCRIPTIONS' | 'CONTRIBUTIONS'

Output only. The configured payment option.

productsstring[]

Output only. The list of active products/features enabled for this publication.

publicationIdstring

Output only. The unique identifier of the publication.

publicationPrivacyPolicyUrlstring

Optional. The URL to the publisher's Privacy Policy.

publicationTosUrlstring

Optional. The URL to the publisher's own Terms of Service.

publicationType'PUBLICATION_TYPE_UNSPECIFIED' | 'FOR_PROFIT' | 'NON_PROFIT'

Optional. The publication entity type (for-profit vs non-profit). Defaults to FOR_PROFIT if omitted.

regionCodestring

Required. The ISO 3166-1 alpha-2 region code where the publication is registered (e.g., "US").

Response

Successful response

Changes

  • c51436940f54Revision changes
    • breaking

      removed the request body

    • breaking

      removed the media type */* for the response with the status

  • 534f2cc7e02fRevision changes
    • warning

      removed the request property //

    • warning

      removed the request property //

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • info

      the security scope https://www.googleapis.com/auth/webcontentpublisher.publications.manage.system was added to the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/webcontentpublisher.publications.manage.system was added to the endpoint's security scheme Oauth2c

    • info

      the security scope https://www.googleapis.com/auth/subscribewithgoogle.publications.entitlements.manage was removed from the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/subscribewithgoogle.publications.entitlements.manage was removed from the endpoint's security scheme Oauth2c

    • info

      added the new optional request property

    • info

      added the new optional request property //

    • info

      the request optional property // became read-only

    • info

      the request optional property / became read-only

    • info

      added the optional property to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      the response optional property // became read-only for the status

    • info

      the response optional property / became read-only for the status