CSS API (css:v1)

2024-07-10

11 new methods | New API

Additions

    Methods
  • css.accounts.listChildAccounts

      Path: v1/{+parent}:listChildAccounts

      Flat Path: v1/accounts/{accountsId}:listChildAccounts

      HTTP Method: GET

      Parameters:

        parent

          Description: Required. The parent account. Must be a CSS group or domain. Format: accounts/{account}

          Pattern: ^accounts/[^/]+$

          Location: path

          Required: Yes

          Type: string

        labelId

          Description: If set, only the MC accounts with the given label ID will be returned.

          Location: query

          Type: string

          Format: int64

        fullName

          Description: If set, only the MC accounts with the given name (case sensitive) will be returned.

          Location: query

          Type: string

        pageSize

          Description: Optional. The maximum number of accounts to return. The service may return fewer than this value. If unspecified, at most 50 accounts will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

          Location: query

          Type: integer

          Format: int32

        pageToken

          Description: Optional. A page token, received from a previous `ListChildAccounts` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListChildAccounts` must match the call that provided the page token.

          Location: query

          Type: string

      Parameter Order: parent

      Scopes: https://www.googleapis.com/auth/content

      Description: Lists all the accounts under the specified CSS account ID, and optionally filters by label ID and account name.

  • css.accounts.get

      Path: v1/{+name}

      Flat Path: v1/accounts/{accountsId}

      HTTP Method: GET

      Parameters:

        name

          Description: Required. The name of the managed CSS/MC account. Format: accounts/{account}

          Pattern: ^accounts/[^/]+$

          Location: path

          Required: Yes

          Type: string

        parent

          Description: Optional. Only required when retrieving MC account information. The CSS domain that is the parent resource of the MC account. Format: accounts/{account}

          Location: query

          Type: string

      Parameter Order: name

      Scopes: https://www.googleapis.com/auth/content

      Description: Retrieves a single CSS/MC account by ID.

  • css.accounts.updateLabels

      Path: v1/{+name}:updateLabels

      Flat Path: v1/accounts/{accountsId}:updateLabels

      HTTP Method: POST

      Parameters:

        name

          Description: Required. The label resource name. Format: accounts/{account}

          Pattern: ^accounts/[^/]+$

          Location: path

          Required: Yes

          Type: string

      Parameter Order: name

      Scopes: https://www.googleapis.com/auth/content

      Description: Updates labels assigned to CSS/MC accounts by a CSS domain.

  • css.accounts.labels.list

      Path: v1/{+parent}/labels

      Flat Path: v1/accounts/{accountsId}/labels

      HTTP Method: GET

      Parameters:

        parent

          Description: Required. The parent account. Format: accounts/{account}

          Pattern: ^accounts/[^/]+$

          Location: path

          Required: Yes

          Type: string

        pageSize

          Description: The maximum number of labels to return. The service may return fewer than this value. If unspecified, at most 50 labels will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

          Location: query

          Type: integer

          Format: int32

        pageToken

          Description: A page token, received from a previous `ListAccountLabels` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListAccountLabels` must match the call that provided the page token.

          Location: query

          Type: string

      Parameter Order: parent

      Scopes: https://www.googleapis.com/auth/content

      Description: Lists the labels assigned to an account.

  • css.accounts.labels.create

      Path: v1/{+parent}/labels

      Flat Path: v1/accounts/{accountsId}/labels

      HTTP Method: POST

      Parameters:

        parent

          Description: Required. The parent account. Format: accounts/{account}

          Pattern: ^accounts/[^/]+$

          Location: path

          Required: Yes

          Type: string

      Parameter Order: parent

      Scopes: https://www.googleapis.com/auth/content

      Description: Creates a new label, not assigned to any account.

  • css.accounts.labels.patch

      Path: v1/{+name}

      Flat Path: v1/accounts/{accountsId}/labels/{labelsId}

      HTTP Method: PATCH

      Parameters:

        name

          Description: The resource name of the label. Format: accounts/{account}/labels/{label}

          Pattern: ^accounts/[^/]+/labels/[^/]+$

          Location: path

          Required: Yes

          Type: string

      Parameter Order: name

      Scopes: https://www.googleapis.com/auth/content

      Description: Updates a label.

  • css.accounts.labels.delete

      Path: v1/{+name}

      Flat Path: v1/accounts/{accountsId}/labels/{labelsId}

      HTTP Method: DELETE

      Parameters:

        name

          Description: Required. The name of the label to delete. Format: accounts/{account}/labels/{label}

          Pattern: ^accounts/[^/]+/labels/[^/]+$

          Location: path

          Required: Yes

          Type: string

      Parameter Order: name

      Scopes: https://www.googleapis.com/auth/content

      Description: Deletes a label and removes it from all accounts to which it was assigned.

  • css.accounts.cssProductInputs.insert

      Path: v1/{+parent}/cssProductInputs:insert

      Flat Path: v1/accounts/{accountsId}/cssProductInputs:insert

      HTTP Method: POST

      Parameters:

        parent

          Description: Required. The account where this CSS Product will be inserted. Format: accounts/{account}

          Pattern: ^accounts/[^/]+$

          Location: path

          Required: Yes

          Type: string

        feedId

          Description: Required. The primary or supplemental feed id. If CSS Product already exists and feed id provided is different, then the CSS Product will be moved to a new feed. Note: For now, CSSs do not need to provide feed ids as we create feeds on the fly. We do not have supplemental feed support for CSS Products yet.

          Location: query

          Type: string

          Format: int64

      Parameter Order: parent

      Scopes: https://www.googleapis.com/auth/content

      Description: Uploads a CssProductInput to your CSS Center account. If an input with the same contentLanguage, identity, feedLabel and feedId already exists, this method replaces that entry. After inserting, updating, or deleting a CSS Product input, it may take several minutes before the processed CSS Product can be retrieved.

  • css.accounts.cssProductInputs.delete

      Path: v1/{+name}

      Flat Path: v1/accounts/{accountsId}/cssProductInputs/{cssProductInputsId}

      HTTP Method: DELETE

      Parameters:

        name

          Description: Required. The name of the CSS product input resource to delete. Format: accounts/{account}/cssProductInputs/{css_product_input}

          Pattern: ^accounts/[^/]+/cssProductInputs/[^/]+$

          Location: path

          Required: Yes

          Type: string

        supplementalFeedId

          Description: The Content API Supplemental Feed ID. The field must not be set if the action applies to a primary feed. If the field is set, then product action applies to a supplemental feed instead of primary Content API feed.

          Location: query

          Type: string

          Format: int64

      Parameter Order: name

      Scopes: https://www.googleapis.com/auth/content

      Description: Deletes a CSS Product input from your CSS Center account. After a delete it may take several minutes until the input is no longer available.

  • css.accounts.cssProducts.get

      Path: v1/{+name}

      Flat Path: v1/accounts/{accountsId}/cssProducts/{cssProductsId}

      HTTP Method: GET

      Parameters:

        name

          Description: Required. The name of the CSS product to retrieve.

          Pattern: ^accounts/[^/]+/cssProducts/[^/]+$

          Location: path

          Required: Yes

          Type: string

      Parameter Order: name

      Scopes: https://www.googleapis.com/auth/content

      Description: Retrieves the processed CSS Product from your CSS Center account. After inserting, updating, or deleting a product input, it may take several minutes before the updated final product can be retrieved.

  • css.accounts.cssProducts.list

      Path: v1/{+parent}/cssProducts

      Flat Path: v1/accounts/{accountsId}/cssProducts

      HTTP Method: GET

      Parameters:

        parent

          Description: Required. The account/domain to list processed CSS Products for. Format: accounts/{account}

          Pattern: ^accounts/[^/]+$

          Location: path

          Required: Yes

          Type: string

        pageSize

          Description: The maximum number of CSS Products to return. The service may return fewer than this value. The maximum value is 1000; values above 1000 will be coerced to 1000. If unspecified, the maximum number of CSS products will be returned.

          Location: query

          Type: integer

          Format: int32

        pageToken

          Description: A page token, received from a previous `ListCssProducts` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListCssProducts` must match the call that provided the page token.

          Location: query

          Type: string

      Parameter Order: parent

      Scopes: https://www.googleapis.com/auth/content

      Description: Lists the processed CSS Products in your CSS Center account. The response might contain fewer items than specified by pageSize. Rely on pageToken to determine if there are more items to be requested. After inserting, updating, or deleting a CSS product input, it may take several minutes before the updated processed CSS product can be retrieved.