civis (version 1.6.1)

media_put_optimizations_shares_groups: Set the permissions groups has on this object

Description

Set the permissions groups has on this object

Usage

media_put_optimizations_shares_groups(id, group_ids, permission_level,
  share_email_body = NULL, send_shared_email = NULL)

Arguments

id

integer required. ID of the resource to be shared

group_ids

array required. An array of one or more group IDs

permission_level

string required. Options are: "read", "write", or "manage"

share_email_body

string optional. Custom body text for e-mail sent on a share.

send_shared_email

boolean optional. Send email to the recipients of a share.

Value

A list containing the following elements:

readers

list, A list containing the following elements:

• users array,

• groups array,

writers

list, A list containing the following elements:

• users array,

• groups array,

owners

list, A list containing the following elements:

• users array,

• groups array,

totalUserShares

integer, For owners, the number of total users shared. For writers and readers, the number of visible users shared.

totalGroupShares

integer, For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.