GDataYouTubeComment

GDataYouTubeComment — GData YouTube comment object

Stability Level

Unstable, unless otherwise indicated

Synopsis

#include <gdata/services/youtube/gdata-youtube-comment.h>

                    GDataYouTubeComment;
                    GDataYouTubeCommentClass;
GDataYouTubeComment * gdata_youtube_comment_new         (const gchar *id);
const gchar *       gdata_youtube_comment_get_parent_comment_uri
                                                        (GDataYouTubeComment *self);
void                gdata_youtube_comment_set_parent_comment_uri
                                                        (GDataYouTubeComment *self,
                                                         const gchar *parent_comment_uri);

Object Hierarchy

  GObject
   +----GDataParsable
         +----GDataEntry
               +----GDataComment
                     +----GDataYouTubeComment

Properties

  "parent-comment-uri"       gchar*                : Read / Write

Description

GDataYouTubeComment is a subclass of GDataComment to represent a comment on a GDataYouTubeVideo. It is returned by the GDataCommentable interface implementation on GDataYouTubeVideo.

It's possible to query for and add GDataYouTubeComments, but it is not possible to delete GDataYouTubeComments from any video using the GData API.

Comments on YouTube videos can be arranged in a hierarchy by their "parent-comment-uri"s. If a GDataYouTubeComment's parent comment URI is non-NULL, it should match the GDATA_LINK_SELF GDataLink of another GDataYouTubeComment on the same video (as retrieved using gdata_entry_look_up_link() on the comments). Comments with "parent-comment-uri" set to NULL are top-level comments.

Details

GDataYouTubeComment

typedef struct _GDataYouTubeComment GDataYouTubeComment;

All the fields in the GDataYouTubeComment structure are private and should never be accessed directly.

Since 0.10.0


GDataYouTubeCommentClass

typedef struct {
} GDataYouTubeCommentClass;

All the fields in the GDataYouTubeCommentClass structure are private and should never be accessed directly.

Since 0.10.0


gdata_youtube_comment_new ()

GDataYouTubeComment * gdata_youtube_comment_new         (const gchar *id);

Creates a new GDataYouTubeComment with the given ID and default properties.

id :

the comment's ID, or NULL

Returns :

a new GDataYouTubeComment; unref with g_object_unref()

Since 0.10.0


gdata_youtube_comment_get_parent_comment_uri ()

const gchar *       gdata_youtube_comment_get_parent_comment_uri
                                                        (GDataYouTubeComment *self);

Gets the "parent-comment-uri" property.

self :

a GDataYouTubeComment

Returns :

the parent comment URI, or NULL

Since 0.10.0


gdata_youtube_comment_set_parent_comment_uri ()

void                gdata_youtube_comment_set_parent_comment_uri
                                                        (GDataYouTubeComment *self,
                                                         const gchar *parent_comment_uri);

Sets the "parent-comment-uri" property to parent_comment_uri.

Set parent_comment_uri to NULL to unset the "parent-comment-uri" property in the comment (i.e. make the comment a top-level comment).

See the online documentation for more information.

self :

a GDataYouTubeComment

parent_comment_uri :

a new parent comment URI, or NULL

Since 0.10.0

Property Details

The "parent-comment-uri" property

  "parent-comment-uri"       gchar*                : Read / Write

The URI of the parent comment to this one, or NULL if this comment is a top-level comment.

See the documentation for GDataYouTubeComment for an explanation of the semantics of parent comment URIs.

Default value: NULL

Since 0.10.0