Ruby

client.branding

كل دالّة في مساحة الأسماء هذه: توقيعها ومعلماتها وما تُرجعه ومثال عليها.

الدوالّ

The brand of the workspace: its mark, its logo and its logo for dark mode, its primary and secondary fonts, and the background of the sign-in page of its web app address. Read it, change the fonts and the background, and upload or remove each image.

`branding.get`

Read the brand of the workspace

settings:read

التوقيع

get(api_key: nil) -> Hash

Returns the brand of the workspace, as its Customisations page shows it: a link to each brand image in images, the primary and secondary fonts in fonts, and the background of the sign-in page in loginBackground.

The mark shows in the workspace switcher. The logo shows at the top of the sidebar, and it is what brands the web app address and, on a paid plan, the emails OpenEmail sends for the workspace, at their top and foot. Without a logo, both look like OpenEmail. The fonts apply in the web app for everyone in the workspace, the primary font to its text and the secondary font to page headings, and the sign-in background shows on the web app address, either way.

A personal space carries no brand, so every image and font reads as nil there and editable is false.

المعلمات

api_keyString: Overrides the client's API key for this call only.

يُرجع

A Hash with object set to branding, editable, images, fonts and loginBackground. images holds mark, wordmark, wordmarkDark and loginBackground, each a URL or nil. fonts holds primary and secondary, each a font id from OpenEmail::BRAND_FONT_IDS or nil for the default. loginBackground is a Hash with kind, preset, color and logo, or nil for the default, where logo is dark, light or nil to match the background.

مثال

branding = client.branding.get puts branding[:images][:wordmark] || "no logo", branding[:fonts][:primary] || "the default font"

ملاحظات

editable says whether this key may change the brand. It is false in a personal space, for a key without settings:write, and for a key limited to particular addresses or domains.
A loginBackground of kind image never reads back without its photo: once the photo is removed it reads as the preset or colour kept with it, or as nil.

متاح أيضًا في

API: GET /branding
TypeScript: branding.get()
Python: branding.get()
CLI: openemail branding get

`branding.update`

Change the fonts and the sign-in background of the brand

settings:write

التوقيع

update(body = nil, api_key: nil, **fields) -> Hash

Changes the fonts, the sign-in page background or both, and returns the brand in the same shape as get. A field left out keeps its value, and so does a font left out of fonts:. loginBackground: replaces the background there was, and nil sets the default.

With kind: "image" the sign-in page shows the photo uploaded with upload_image("login-background", ...), so upload that first: without it the call is refused. Uploading one switches the page to it on its own, so most callers never send kind: "image" themselves.

المعلمات

fontsHash: The fonts to change. Leave it out to keep both.
fonts.primaryString or nil: The primary font: one of the ids in OpenEmail::BRAND_FONT_IDS, such as inter or georgia, or nil for the default. Left out, it keeps its value.
fonts.secondaryString or nil: The secondary font, an id from OpenEmail::BRAND_FONT_IDS or nil for the default. Left out, it keeps its value.
loginBackgroundHash or nil: The sign-in page background, replacing the one there was, or nil for the default. Leave it out to keep it.
loginBackground.kindString: preset, color or image. Required once loginBackground is given.
loginBackground.presetString or nil: dusk, mist, sand or night. Required when kind is preset, and kept for later otherwise.
loginBackground.colorString or nil: A colour as # and six hex digits, such as #1f2937, stored lowercased. Required when kind is color, and kept for later otherwise.
loginBackground.logoString or nil: dark shows your logo and light your logo for dark mode. Nil, the default, picks the one that stands out against the background.
api_keyString: Overrides the client's API key for this call only.

يُرجع

The same Hash as branding.get, as the call left it.

مثال

branding = client.branding.update(  fonts: {primary: "inter", secondary: "georgia"},  loginBackground: {kind: "color", color: "#1f2937"}) p branding[:fonts], branding[:loginBackground]

ملاحظات

A font that is not on the list, a preset background with no preset, an image background while no sign-in photo is uploaded, or a colour that is not # and six hex digits is refused with 422 invalid_parameter, and param names the field, such as fonts.primary or loginBackground.kind. Any other field is 422 unknown_parameter.
A personal space carries no brand, so the call is refused there with 409 branding_unavailable.
The brand applies to the whole workspace, so a key or app limited to particular addresses or domains is refused with 422 capability_unsupported on domainAllowlist. Such a key can still read it with get.
Retried automatically on network failure and retryable statuses, since sending the same change twice leaves the same brand.

متاح أيضًا في

API: PATCH /branding
TypeScript: branding.update()
Python: branding.update()
CLI: openemail branding update

`branding.upload_image`

Upload one of the brand images

settings:write

التوقيع

upload_image(variant, data, content_type: nil, api_key: nil) -> Hash

Sends the image bytes as the request body, replacing the image there was, and returns the brand. variant names the image: mark, the square icon, wordmark, the logo, wordmark-dark, the logo for dark mode, or login-background, the photo behind the sign-in page of the web app address.

Up to 5 MB goes in, and it is fitted and stored as WebP: the mark into 512 by 512 pixels, the two logos into 1024 by 256, and the sign-in photo into 2560 by 1600. The mark and the logos take SVG, PNG, JPEG or WebP, and the sign-in photo PNG, JPEG, WebP or GIF. An SVG is turned into a picture, and an animated image keeps its first frame.

Uploading the sign-in photo also switches the sign-in page to it. The type is read from content_type:, or, when that is left out, from the content_type of data itself or the extension of its file name, and without either the server refuses the bytes with 422 invalid_image.

المعلمات

variantStringمطلوب: mark, wordmark, wordmark-dark or login-background.
dataString, IO or Pathnameمطلوب: The image: a binary String, an IO or a Pathname.
content_typeString: image/svg+xml, image/png, image/jpeg, image/webp or image/gif. Required unless data carries its type, as an object with a content_type or a Pathname or File named with the extension of the type.
api_keyString: Overrides the client's API key for this call only.

يُرجع

The same Hash as branding.get, with the new image in images.

مثال

branding = client.branding.upload_image("wordmark", File.binread("logo.svg"), content_type: "image/svg+xml") puts branding[:images][:wordmark]

ملاحظات

An image of a type that variant does not take, one over 5 MB, or one that cannot be read is refused with 422 invalid_image, and a variant that is not one of the four with 422 invalid_parameter on variant.
A personal space carries no brand, so the call is refused there with 409 branding_unavailable.
The brand applies to the whole workspace, so a key or app limited to particular addresses or domains is refused with 422 capability_unsupported on domainAllowlist. Such a key can still read it with get.
A busy image service answers 503 image_busy and a failed save 502 image_not_stored, which the SDK retries like any other retryable status.

متاح أيضًا في

API: PUT /branding/images/{variant}
TypeScript: branding.uploadImage()
Python: branding.upload_image()
CLI: openemail branding upload-image

`branding.remove_image`

Remove one of the brand images

settings:write

التوقيع

remove_image(variant, api_key: nil) -> Hash

Removes one brand image, deletes the stored file and returns the brand, so the default shows in its place. Removing the sign-in photo while the sign-in page shows it switches the page back to the preset or colour chosen before it, or to the default. Removing an image that is not set changes nothing.

المعلمات

variantStringمطلوب: mark, wordmark, wordmark-dark or login-background.
api_keyString: Overrides the client's API key for this call only.

يُرجع

The same Hash as branding.get, without that image.

مثال

branding = client.branding.remove_image("login-background") p branding[:images][:loginBackground], branding[:loginBackground]

ملاحظات

A personal space carries no brand, so the call is refused there with 409 branding_unavailable.
The brand applies to the whole workspace, so a key or app limited to particular addresses or domains is refused with 422 capability_unsupported on domainAllowlist. Such a key can still read it with get.
Retried automatically on network failure and retryable statuses, since a second attempt after one that went through finds nothing to remove.

متاح أيضًا في

API: DELETE /branding/images/{variant}
TypeScript: branding.removeImage()
Python: branding.remove_image()
CLI: openemail branding remove-image

client.branding

الدوالّ

المعلمات

يُرجع

مثال

ملاحظات

متاح أيضًا في

المعلمات

يُرجع

مثال

ملاحظات

متاح أيضًا في

المعلمات

يُرجع

مثال

ملاحظات

متاح أيضًا في

المعلمات

يُرجع

مثال

ملاحظات

متاح أيضًا في

صندوق بريدك،بشروطك أنت.

صندوق بريدك،
بشروطك أنت.